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Introduction 


W youT^how'Jo ^ h EdUi "" a buok -™en ,o help 

mance Of your programs In a nutshell \hu ' subroul,n e* to '"crease the perfor- 
assembly language to work in a mea, m^u^ a y ” deS ' 8 " cd t0 hc, P * ou Put 

_ ),ou wri " programs in BASH r _ 

.ucrocomputers and you want to make the r C++ ° n the 1BM family of 
Using Assembly Language, 3rd Edition a helrfu' ,° f V ° Ur Programming, you'U find 
Each carefully designed chapter is packed “‘T’"’ 8 aid and reference guide 
of assembly language subroutines m hlh-lcvcUu”* lnformatio n abourshe use 

This book is written horn a nrce ^ 

pies are Included to teach you the Prece P“ and «*»»- 

use of assembly language Also included ,-e de.J, obecomt Proficient in the 
on the framework developed in the first ‘ ' afcrence materials Buildine 

3rd Edition, covers more languages and morTCmbi?^ La "* u °*' 

other assembly language book available. y angua B e 10015 than any 

commands, and functions—how they are used and whfktgK inslru «ionp, 

"black boxes" herc-nothing mysmnous or ^ T*~ '"° 

understanding assembly language, you will learn ho-v to make h^’ > “"V By 
particular IBM environment. better use of your 

precepts and underlying concepts on wh.ch the fields complex IdeuaebCilf I Ve 
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tried to simplify many of the concepts the assembly language programmer must 
understand, so that you will lose neiiher your interest in nor your focus on these 

guiding precepts. 

I’ve included many examples that you can try on your computer Working 
tnrough these examples on the computer (or even in your mind) should help you 
retain key ideas. I recommend that you use the computer as you read the book. It 
you want, you can also get the programming examples on disk; an order form is 

included at the back of the book. 

Clearly, Using Assembly Language, 3rd Edition, is not intended as fight, after- 
dinner reading. It is meant to provide a sound basis in the principles o eve 
assembly language subroutines, tapping the internal power of BIOS *' 
functions, and interring assembly language subroutines to high-level language 
programs. You can use many sections of the book as reference. 


Why Use Assembly Language? 

Broadly, assembly language falls into the category of a low-level language—in 
fact many people consider it the only low-level language. As an assembly language 
programmer, you need co be more concerned and aware of wha, .he computer is 
rapfble of and how it performs asks tl .an you are when you program m a high- 
level language High-level languages such as BASIC. Pascal. C, or C++ muroduce 
levels of abstraction dial free you from needing to worry much about the hardware, 
many of these languages are portable to differing computers. 

You may ask, “Why should I use assembly language?" There s no 
The reasons for us-.g assembly language vary, depending on 
which you use it and -he high-level language you use as the controllmgp granr 
brief took at ute dev apment of high-level languages may help you better 
stand the value of " 'scmbly language. 

Assembly language once was the only Ian ^ ua ^^ 1 ^ ^enPascaLand later 

Butwithdicadventofhi^aevellanguagessuchas^ ^ [Q assembly 

C. many programmers andprovided most of the functions 

language, these languages £as o(te n relegated to program- 

ordinarily needed to program. AssemD y & 

mers in research labs (and padded cells)- 

Over time, as applications 

high-level languages were tested a P |ha| lhcrc mus t be a faster, slicker, 

you have experienced the frosuauo f^ ^ ^ do wuh.the high-level 

more efficient way to d ° S °" , lon has led some programmers to change 
language you’re using. This trust™ 
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languages (hoping to find one that adrlrecc#»rf 

accept the limitations of their current high^d?™^^' ° f ^ " eeds) ° r lo 

■nto machine language-the native l?^ 7 la " gul 8e mnemonics translate directly 
than machine C<; N ° ta *“» “ 

computer. Because assembly language is the m™ possible on any given 

languages, assembly language runs faster Uun^of^^^™*"™*^ 

tive and C ° mp “ ed - or P seu docode Interpie- 

cequire some transfa.L imo ^"e ^age j ^ 

that, depending on the implementation of St i? * ^ time ° f cxecuti <>n. It is true 
once compiled, require no such ^on'^ 5 °™'^'evelllanguages 
source-code files, once assembled, never reauire tn i ^ Bm assem bly language 
penalty of greater execution time. Q Uuon; they have no overhead 

Assembly language is versatile. Anything thar , 

computer can be done with assembly language TOe * * done ««•» a 

imagination and the capacity of the computer sysmm you ln's'Tng 0 '’ ^ r0ur 

Many high-level languages are designed to execute nn „ .1 

computers, each of which has different capabilities and ten h ^ Varie,y of 
guages are designed for the “lowest cnmm«„ h nes . and P«npherak. These lan- 

capabilities and peripherals likely to be on virtuauf^tv^^ COVCr the 
might run Assembly language ° n *** ** 

ties of your specific machine are the only limiting famr asmrtbM* ‘ he apabili - 
great versatility in program development. * or, assembly language allows 

langua^ l i^totfSr/fa^mb^bnguaaerivesvn.i ^nM!fcrt^f T | t7 * ) f ° f CPU ' “ se "> b 'y 
one task. Some languages have ri«id^^^„. 4y ° f ^ t ° acco, ”P ll,h 
approaches to coding a panicular task As^mM 1 a * rcstnct lhc number of 

If your coding stylel 

hacks; you can easily end up with "spaghem^ Sf°^ P ,XXf 
fl sT r re0n V le “' WriK d «‘P'i"cd. structured rode), you lilt^e 
C^nglnga" - - b “' b 
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Assembly language produces compact code. Because assembly language 
routines are written for a specific purpose in a language that translates directly into 
machine language, these routines will include code that only you. the programmer. 

want included. 

High-level languages, on the other hand, are written for a general audience 
and include extraneous code. For instance, many high-level languages include, 
intrinsic graphics functions or file-handling functions used by only a few applica¬ 
tions. Needed or not, this irrelevant coding is included in every application. 

Because assembly language mnemonic instructions translate directly mioone 
or, at most, several bytes of data, there is np overhead unless you specifically choo 
to include it in your executable file. 


What You Should Know 

In any book, assumptions are made about what the reader knows. Those 
assumptions may be stated up front or may become dear after you'wread the boo 
Before you read this book, you need to know what the assumptions are. 

First, it is assumed that you know a, least one high-lt 
Pascal C or C+ +—or one of the database languages such as dBASE. These are used 
throughout this book. (If you know more than one of these languages, yo 
benefit even more from Using Assembly language, 3rd Edition .) 

You should be familiar with ASCII, the native coding scheme used for character 
representation on the IBM PC family of:mlerocomputmto^*®^ ««««« 

subroutines in this bopk (and elsewhere) use and “f ™ ™c”fable 

don't need to memorize the entire code, but you may want to beepmKAMaoa 
within reach while you work through this book. Appendix A u an ASCII cnart. 

Because you're reading WMJ 

have had experience programming and that you 21 decimal 

numbering with octal (base 8).'so much 

(base 10), and hexadecimal (b , ^_ y If ou have trouble working with 

the better, but familiarity with octal is not ncccss “|\ y . , d ickly provide all the 
any of these s>stemswriting^mWylangm®eo ^ q }rd Edition . doesn't 

differences ZZl numbering systems or the reasons for using 

binary or hexadecimal systems. 

Depending on your programmingbackground, ^ ^ „ h cren^poss * b' I' 1 ' c s for 

different notations for numbering systems. Because o numbers, some 

• confusion when you work with binary, dectmal. and hexadectrna 
sort of notation is needed to differentiate between the s, stems. 
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is S ! mple and s,rai l* tf °™'«d ; a lowercase b 

-"-be- havTno ap^a* 


raft/e J.l. Numfcer representation 


Binary 

00001110 b 
01101011 b 
10111011 b 
11010101 b 
0000000110110000 b 
0000001001010101 b 
0000001101100111 b 
ooooioimimnb 

oioiiinninooob 


Decimal 

14 
107 
187 
213 
432 
597 
871 
3071 
24568 


OEh 
6Bh 
BBh 
D5h 
OlBOh 
0255h 
0367h 
OBFFh 
5FF8h 


even number of digits. Every digutn 2 'bhT ^ he * adecim,d numbers occupy an 
digits of a hexadecimal „ U m7e r Z ££-«™ber represents a bU. Every two 
represent a word, or two bytes. As an a*« 7kf ’ f r Cl8 b- b ,ls ’ and every four digits 
learn to think in grouping^bits^es^ndwLds 0 ^ 386 prORrammcr - y° u 

!, h ? d te -- certain 

definitions should prove helpful a, this point and" d^ou^om Ae^lt' 

guage'mnTmonics^nto^nucfdne'^mguage^r^irect^xeajOo'n^^th^"' 11 ^ 

is understandable n ^o <, hunuru E A^embly l knguage C is a not C d!iecdy UrCeC( tabi ^ 

SSS2S«»meu d nlT7 bler$ *7 * 

others. This book concenna.es on *e 3^!^“ “ m ‘“‘ ng ^ * he 
UNK^ieCHd PmC " S ^ linke " ‘ nC ' Ude 
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^ using Assembly Language, 3rd Edition 


Unking: The process of resolving external references and address references 
in object code. The resulting machine language instructions are directly executable 

by a computer. 

Machine Language: The series of binary digits executed by a microprocessor 
r accomplish individual tasks. People seldom (if ever) program in machine 
language. Instead, they program in assembly language and use an assembler to 
translate their instructions into machine language. 

Object Code: A half-way step between sou.:e code and executable machine 
language. Object code, which is not directly executable by a computer, must go 
through a linking process that resolves external references and address references. 

Source Code: The assembly language instructions written by a programmer 
and then translated into object code by an assembler. 


What Is Covered in This Book 


Whenever I pick up a book, the first thing I want to know is whether the book 
will help me. Will it teach me what I need to know’? 

You can see from the table of contents that Using Assembly Language, 3rd 
Edition, covers many technical areas related to assembly language programming^ 
For easy reference, the book is divided into four parts. The following is a quick 
outline of the contents of each chapter. 

Part I, “The Fundamentals of Assembly Language." Chapter 1, “Under¬ 
standing the Programming Environment," introduces you to the basic information 
you need to successfully program in assembly language on Intel microprocessors 
in the IBM family of computers. 


Chapter 2, “An Overview of Assembly Language,” introduces you to the basics 
of programming in assembly language. This chapter touches on the structure, mam 
commands, and operations needed to use assembly language. 


Chapter 3. “Choosing and Using Your Assembler," explains what ^assemb 
Iocs, describes a couple of the most popular assembler programs, and d 
he common ways in which these programs operate. 

Chapter 4. -Choosing and Using Your linker, ’compares dirIWpo^ 
linker programs and explains how to link assembled programs. LINK parameters 
and file types are Included in this chapter. 

Chanter 5 “Using Microsoft’s Assembly Language Products," covers the assem- 
blcr and ifnker ivailabte from Microsoft. In this chapter you learn, through a hands- 
session, how MASM 6.0 docs its work. 
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Chapter 6 , “Using Borland’s As^mKi i 

same tasks in relation to Borland’s assembler and'lml Pr " dUC,S " ac ™mpl,shes the 
on example, you leam how ,o deveTon ^semh 1 ^ hr ° U8h a dc,ailed 
program developed in Borland C++ P> b e ’ a ° d ink a subr °utine with a 

D ^o”pro^ U S 8 c ^^ Subroutines." shows how to use 

debuggers, such as CodeView and TurtJn* k ° f °" C ° f lhe P°P ulaf symbolic 
locate, isolate. ,„d correct errom and^ob.ems^embM ^ ^ 10 

Chapter 8 -rstn. .a.-. assembly language subroutines, 

profilers to speed your work'YTu'lelm whvTeseT ^ '° make fi,es and 
diey can do for you. ^ ese lo °b are so popular and what 

Of 0 b,ect.fde ^'ra^es^^sCTnW^nguage siTbrcHjt| t nes' 0n ’ 

«r 10 •^merfec“t d S^Ses^ 0 ^e^" 8 ^ f“ bl >' ^fioage." chap- 
*“"** language subroutines with h^-.e^rng'^Cm? 0 ' 

“amples of using assembly 'brng^^subrour ' 5 Spccific lnform ation about anti 
compiled BASIC. ^ Ke subr °uiincs from both interpretive ild 

Chapter 12, "Interfacing with Pascal „■ 

non for programs written in Pascal ' 8 “ y ° U Specific '"terfacing mforma- 
'anguage subrou'tines ^h‘*e” mos^pu^ oftn^age^ “ 

a^r; £gi"a£t^ 

Chapter 15, "Interfacing with Clipper" sh„ k ^ 

Partin, Applying Assembly Language TWh«s • w 
wth D^erem Processors," explain how^iscnv^T” Chlpler 16 ’ "forking 

romwlpa,,, (ft™. ^«^^^ p ^^' 1 ^‘ , l n 'ViMlii«o«ho W 
play, of information on a computer mornlor ^ *” COntrol d *" 

from assembly I a n gu a”e'^cajmJi e^m r i° H S " C ° Wn workin * “ *' hardware level 
controllers. * &>mple5 ,ndude ^cessing the keyboard andspeator 

on howS fiTp^r D “ kDriVCS " coverstowlev *' d “kaccess,focusing 
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Par* IV -Reference.’* Chapter 20. “Accessing DIOS Services." details the BIOS 
interrupts and services and the tasks they perform. Corresponding information 
for the different DOS interrupts and services is included in Chapter 21, The DOS 

Services.” c 

Chapter 22. “Processor Instruction Set." provides detailed reference informa¬ 
tion for the Intel 8080/8088. 80286. 80386, 80486, 8087, 80287, and 80387. 

Chapter 23, “Assembler Directives,” covers all the extended capabilities added 
to MASM and TASM through directives. Through the use of directives, you can make 
your assembler do much of the “grunt work** of assembly language for you 

automatically. 

Using Assembly Language , 3rd Edition, contains rwo useful appendixes. 
Appendix A presents the standard ASCII character codes, and the BIOS keyboar 
codes and keyboard controller codes are included in Appendix B. 

Finally, Using Assembly Language, 3rd Edition, contains a brief glossary. 


What Is Not Covered 
in This Book 


Using Assembly Language, 3rd Edition, is packed with information but can¬ 
not possibly cover all related subjects. This book has limits. 

First, this book does not teach high-level languages. In fact, it does not purport 
to teach any language. Its purpose is to show how to make two languages— assembly 
language ami BASIC, Pascal, C, C++, or your database language-work together 
for the benefit of both the program and programmer. 

As you read and work through this book, you probably will learn something 
about each of these languages. You’ll undoubtedly learn a great deal about assembly 
language but please don’t feel that you’ve learned it all. Learning how to do things 
wSnato jJU-and by then the rales have all changed. And don't be 
Tnttdav you learn bom another source a quicker, easier way to do a task thra 
learn here. Part of the fun of living is that people keep develop** new 

ideas and methods. 

Programming stvle is a big deal for many authots. Style is fine and promotes 
logical thbddng, but I believe that coding must meet only a few cnirna: 

Q Is the code Intelligible •? Adequate remarks (perhaps for every line) and 
appropriate line formatting help. 
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decipht^ny^py, , ^ b I?! c COde? rt B ' :CauS<; you may n0 > ** “round to 
code must be made in a monthor'a* >nCR,I ' C coam * wh cn changes to the 

!“* * ,n my ° pWon ' «* “ *• -ugle most-important criterion of all 

mmg conventionvor techniques *“ of P ro *™" 

intelligent, working code to hdnv™, £ this book is to provide clear, concise. 

and optimize your ^ productivc *>u can organize 

the same logical structures and common^'' 8 “ sembl '’ ^nguage programming 
structures and common sense encouraged by high-level languages 

Of th^^ET^um^^ ,B ’**“~h*«. o beyond Ute scope 
manipulation. Indeed, assem^^^i^^^P^ 
tines. For example, the sheer volume of data that must n^f f^ P J”**' 
animauon demands a level of speed available only throu£ 

t “ 

because, on che IBM, certain ASCII codes^Emspond to spc^ch^c!! 

neither textual nor numeric, but clearly graphic. Although the:- haracters ima 

you to enhance an otherwise bland tern screen, the screen is not it^iT!.^™ 

screen. Ten screens deal with data on a character level; graphics soeens 8 ^'^ 
ulate data on a pixel level. - ^ screens marup. 

Using Assembly Language, 3rd Edition, does cover the use of textual graohta 
and color. Library routines that allow all sorts of snazzy screen creations (JtauS 
dm«a««s) wuh assembly language driwnrfnun high-level languages arc di£j*«d 


Summary 


I hope that you now have a sense of what this book Is. as well as what It isn't 

meld^r* fcU , th ' n ”lf° r . lhi5 tyP * ° f book ' wridn 8 It has been important to 
nw. Idealty you also have fell that need. Items missing from the earlieredirions have 

been included in this edition, along with new information yielded by technology. If 
*«y i ormation that you feel belongs in this book is missing, I would like to know 
“out it. Feel free to contact me either through the publisher, at the address on the 
order form at the back of the book, or on CompuServe (72561.2207). 

Now. if you’re ready, let’s begin the process. May yours be a fruitful journey. 
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Understanding the 
Programming 
Environment 


B mem wT” Und . erStand ,he 

tiz est * ro ~ 11115 

their clones use the i-vc-l 8088; the IBM Personal Computer ?C ^ 6?CXTznd 
newer computers uxr the Intel 80386 or 80486 The new USCS Int f 180286 ; 
OS* computers all use one of these four microp^so" ® ^ ° f °° S ° f 

gnunmed for the 8086/8088 will run 

n T n,n °" ^ 80386 and 80486 Thc ** pnxxssors 2 
no S ° hmC ^ for 80386 or 80486 will 

808 -^ ° n **“ 80286 * ™ d that ^tten for the 80286 may not run on the 
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Each generation of microprocessor has added different ins.ruedons and 
,o .he basic se. used in .he 8086/8088. These .mprovrmcn.s 

OPCra,, . n . 6 h t nrocessors from'being downward compatible In addi.ion. you can add 
cvenmore assembly language instiuctions if your compu.er has one of three c ips— 
usually called .he 8087, 80287, or 80387 numenc coprocessors. 

The software env.ronmen. refers .o fea.ures made available through theuseof 
I any type of controlling software. "Controlling software refers P"™" 1 ^ ° 

\ Input/Output System (BIOS) and the Disk Operating System (DOS), but ray refer 
to other software such as DOS extenders, memory managers, dev.ee drivers, 
programs such as Windows. 

This chapter will teach you about key points of both hardware and software in 

the programming environment. You need asolid understanding of this environment 

to pro£am successfully in assembly language. The concepts presented in later 
chapters build upon the foundation in this chapter and Chapter 2, An Overview o 

Assembly Language." 


The 25-Cent Tour of Memory 

• ’ Because assembly language inherently involves working at a level that is much 
closer to the computer than other languages, you need to understand how yo 
computer uses memory. (Other languages generally handle memory and memory 
management automatically.) 

On the IBM PC, running under DOS, as much as 640K of memory is 
(655 360 bytes of storage). Your specific computer system may have additional 
memory (called Ugh memory, extended memory, or expanded memory ,^Unde 
rccular^ plain-van ilia DOS, however, this additional memory isnot directly acces- 
2 in Diet, the mam memory area (the first 640K of memory) a not completely 

available. 

Within main memory, certain areas are reserved for specific predefined use. 
For instance, some of the memory is used for BIOS and DOS Other areas « ■***"’ 
areas that hold information enabling BIOS and DOS to function properly. SttUothcr 
areas may have user-installed resident programs such as memory managers, nctw ° 
drivers, or utility programs like SideKick or ProKey. Figure 1.1 is a typical memory 

map. 
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Chapter 1: Understanding di e Programming Environment 

I I - Sample » 



- ** -«o dos. 

programs. DOS functions allow you to mmSf 0ry conflic « among 

mem ° ry ^ y ° Ur Th-c functions aredeSn^p,^ ^ ° f 

which^":? £ ^ng^r ‘“? "* 6f "*•»* locations „ 
dicu.es the maximum amount of rnermuyacomDut° f ^ —5 

mcfnor i f «* addressable by 
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Address' 
Register 

Bits 


8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 


Addressable 
Memory 
(bytes) 

256 
512 
1,024 
2,048 
4,096 
8,192 
16,384 
32,768 
65,536 
131,072 
-262,144 
524,288 
1,048,576 
2,097,152 
4,194,304 
8 , 388,608 
16,777,216 
33,554,432 
67,108,864 
134,217,728 
268,435,456 
536,870,912 
1,073,741,824 
2,147,483.648 
4,294,967,296 


Memory 

Size 


IK 

2K 

4K 

8K 

16K 

32K 

64K 

128K 

256K 

512K 

1M 

2M 

4M 

8M 

16M 

32M 

64M 

128M 

256M 

512M 

1G 

2G 

4G 


. i , rT t Two memory loca* 
Each memory location requires its <affecting the locations 
tions cannot have the same addres *ff happen if your house and your 

m'ltoan wouldn't know what maU went to which hou« 
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P ° in,l:r (IH) '° kc >-P <«ck of the 
hi. address ' f r C,ngf ’ itCU,l ' <l This pointer, ssimplya J6 . 

•ha. 16l» cffittSta.' ' :r0r, ' ahle T • • you can determine 

' ^ ld mu gers in the* range of 0 to 65,535 

As mentioned earlier th" invt i>r* • 

of memory. If the IP can hold Jnlv 65 5\( n,n R undcr R OS) can have up to640K 
memory locations be addressed*! i n ' ° h °"’ Can each of 65 5.360 possible 

memoty would require an addre ° 1 " ^ * 1C 655 ’* 60 vaiucs necessary- for 640K of 
would be to use a “ ‘T 20 ThC ^ elution 

confusing solution. ’ 1 lnttl used a more indirect and potentially 

^gp^ ™ ~ (segment) of memoty 

of memory can be up to "?£££** segtnem 
departure not or.lv from ,h c mem .._ ,. lHr . ? S ‘ ze ‘ Th,s scheme was a radical 
ecssors but also from the schemes usd'bvmh ' USed in Carlier micr °pro- 
Motorola 68000 family Suddenly ihr nrr ^ ^ m,tro P roce «ors such as the 

of only 6*iK of memory P ‘ rC,Rram C ° U,d add ™ s Erectly a maximum 

^iy in the fm-mat^ ment n ° UU ° n - Cach memor >' location can be addressed individu- 
SSSSrOOOO 

where SSSS is the segment and OOOO is the offset Memnrv I 

format are always in hexadecimal notation The seemenT ° locat,ons 8* v cn in this 

dcpendi "* 

ing the segment value ty lOh (s^h.sa^ de , termined by multi ply- 
ollser value. ' hus, the absolute location of 18^1 521F d and lhen addin 8 *he 

321 Fh. or 1 B92Fh Based on this addressing no^on t ^ 187l ° h P ' US 

addressable memory could range from 0000 0000 (0) to FFFFW ?!^ 
slightly over 1 M (megabyte) of memory. Remember however thafthil r' 9 ?"" 
is 6*»0K; therefore, the calculated absolute memory address rJ * ^ ,m,t f ° r DOS 
(The -missing” 384 K is actually used by the ROM-BIOS video RAM 1 655 * 360 ‘ 

components; it s no, really missing a, all, jus, unavaHa^^' 

Clearly, memory segments can overlap and anv unim.e n™ . 
be addressed in many ways. Table 1.2 shows the nnr« r ory location can 

addresses, all of which refer to the same absolute memory R^ion^^ memory 
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[. Fundamentals of Assembly Language 


Table 1.2. Seg ment/offset pair* 

Segment Notation 

17A5FED0 
1A74.D1E0 
1AFF.C930 
1D90:A020 
1F93-7FFO 
2292:5000 
2515 2*’D0 
265-4 13 E0 
26DO 0C20 
2777:01 BO 
278F;0030 
2^90 0020 
2791 0010 
2 ”92 0000 


addr ess absolute memory location 027920b. 

Physical Address^ Calculation 

17A50h + FEDOh = 27920b 
lA740h + DIEOh = 27920b 
lAFFOh + C930h = 27920b 
1 D900h + A020h = 27920h 
1 f930h + 7FF0h = 27920b 
22920h + 5000h = 27920h 
25150h + 27LX)h = 27920h 
26540h + l3E0h = 27920h 
26D00h + 0C20h = 27920h 
27770h + OlDOh = 27920b 
278F0h + 0030h = 27920h 
27900h + 0020b = 27920h 
27910h + OOlOh = 27920h 
2“920h + OOOOh = 27920h 


Tn create figure 1.2, addresses were attached to the memory map 

fieurell The address in vour system may vary (sometimes greatly) epen 

y™moD configuration, DOS venion, program use. and other factor,. 

If vou are using DOS 5, you can see a fairly detailed memory map^r sour 
system by using the MEM command with the IP command-line switch. The fo 
is anT«mple of what is displayed when you issue the MEM /P command: 


Address 

Name 

Size 

Type 

000000 

000400 

000500 


000400 

000100 

000200 

Interrupt Vector 

ROM communication Area 
DOS Communication Area 

000700 

10 

00OA6O 

System Data 

001160 

MSD0S 

001300 

System Oata 

002530 

10 

0EMM386 

002210 

000970 

System Data 

DEVICE 3 
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10ADHI 

loadhi 

LOAOHI 

|.OAOHI 

LOADHI 

LOAOHI 


004750 

O047A0 

0050FO 

005140 

005290 

005370 

01CA70 


MSDOS 

command 

MSDOS 

COMMAND 

MEM 

MEM 

MSDOS 


O000A0 
0000A0 
0000A0 
0000A0 
0000A0 
0000A0 
000820 
000100 
000200 
0001C0 
000740 
000040 

000940 

000040 

000140 

0000D0 

0176F0 

083580 


DEVICE* 

DEVICE* 

DEVICE* 

OEVICE* 

device* 

DEVICE* 

FILES* 

FCBS* 

buffers* 

lastdrive* 

STACKS* 

System Program 

Program 
*• Free -• 
Environment 
Environment 
Program 
* * Free •. 


S s ivau'rrr 31 — 

yXBS availat) ie to MS-DOS 
6339a* .largest executable program sale 

by,es t0U1 EMS "•■“■■y 

'064969 bytes free Eus memory 

3,4572 0 8 byre! TZ COn,i9UOUS •"—« -mory 
<064960 bytes available iMS^Zry 

MS-OOS resident in Hign uemory Area 


-.v in nign Memory Area 

Notice that the mem command do« n^i ^ • 

«n figure 1.2. For instance,!, does not show n *r^^’ me0ft !li e ‘ nformation$how n 

buffets or the ROM area. U,e “S-nning addresses of the video 

the actual memory a^^^ss^n^hiThyour^o^’i^^jJ 199 *? . not * con «">ed about 
process, and subsequent DOS loaders take r ”' de Ph ” icil| y-The linking 

getting i, ready to execute. If you want more info™ ?° SH, ? nin 8 program and . 

will reside, you may want to refer to a more technics! h^ b ? U * whtrc ,hc P ro 8 ra m 
Programmer s Reference , 3rd Edition publi-herf k r?° k ab ° Ul 0051 such xs DOS 
issues such books address is how ^oration. One of the 

execution. If you find this topic intere^T £ ^ ^ beR,n 

attention to the differences between COM and EXE files. " l ° P * Y pan,LU,ar 
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Although you don-t need to worry ^ 

":p 6 — 


Fiji 1 2 Sample memory map u'itb addresses. - 

OOOOOh 

- - 1 

BIOS /DOS Interrupt Vector Tables 


00500h 

OOS Work/System Area 


04C00h 

Device Drivers 

i 

05400h 

COMMAND COM (resident portion) 


OEOAOh 

KBFIX2.COM (resident keyboard 
program) 


OEBEOh 

MSPOOL2.COM (resident print spooler) 


lE720h 

SMARTKEY.COM (resident program) 


26F70h 

SK.COM (SideKick resident program) 


37A80h 

Free memory 


AOOOOh 

Video Butters 


COOOOh 

ROM Area 





The Stack 

A special segment of memory, called the stack, is reserved for the temporary 
storage of data. To program effectively in assembly language^ you must understand 
the stack. Even if you are already familiar with the concepts related to a stack, take 
just a moment to review them. Because later sections of this Book present assembly 
language instructions and routines that rely on the stack, the basics must be c wered 

now. i 
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a last-in! first-out (UFO ^queue 7 t T ^ ’ * StUCk Ca " bc confus,n 8 first. A stack is 
in a cafeteria line Each plate nlae iff™ 0 ^ much like the spring-loaded plate servers 
sjblc. Conversely remov.nl , ? °" ,ht serwr mak “ the '°wer ph.es , nacres- 

Plates can only be removedfnthe* 1 ^ mak ' S ‘ he ° ne under “ '""mediately available, 
las. plate added is always the 

con,a!nsone C ro C rda6^o7dauTh h ‘ hC $ “ Ck ShOW " flBUrc , 3 ' b °* 

of their placement on the start A box “ can be rcmoved ln .he reverse order 
conventional means Data is show Y A' *j ' '° P ° f ,he s,ack is acce5 sible by 
deposited prefaced from $ , 



on a doubleword <32 bits of da.^AhhouBh^ 0 ^’uw'oritfnal" 5 SUCk “ b>Sed 

m ,6b " 


•niroughou. this book, you will see references .0 the stack <t„ m . 
assembly language commands cause information .0 be deposited i“. Some . spec ' f,c 

cause the information to be removed This f | f . nrVk , P j d *n the stack; others 
results from another action vou want ut nerfonn ^Vs^l dhrA 11 ^ / emov ' n 8 frequently 
commands. 1 wil, touch on the specific operations that adfifecnih^sut'clc^ * an ® ua ® e 

assemS^^a^s^uunr^AtTnfo^r A "S'™' “ a " 

■be suck, then removed as neeSXA^Te m^f bep ““ dlis 'I""**onto 
process is covered in detail in the discussion ** r bly . ,an 6 ua « e subroutine. This 
language subtoutines. beginning in Chapter 10.2^^ 
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If you arc a little confused about how the stack works and why '* b 
. n .u|v lancuaec programming. don't despair; such confusion i • 

vou wdrk through ^the examples in this book, pay particular attention to how 
op-rations affect the stack. Doing so should clarify the concepts. 

If you are quite confused about the stack, reread this section until you bcgin 
to grasp°he concepts. Before you can understand the concepts behind assembly 
language programming, you must first understand the stack. 


Registers and Flags 


The 8086/8088 and subsequent generations of Intel 
. , to ooer ate on data and to perform tasks. Registers are special sto g 
^ rfmo the^Troprocessor Mlrcg.slcrs arc .6 bits (. word) ^ but some 
operations can be performed on only one byte (8 bits) of specific registers. Table 1.3 
shows the 8086/8088 register set. 


Table 1.3. The 8086/8088 register ser 
Name Category 



AX 

DX 

cx 

DX 

SI 

D1 

SP 

BP 

CS 

DS 

SS 

ES 

IP 

FLAGS 


General purpose 

General purpose 

General purpose 

General purpose 

Index 

Index 

Suck 

Suck 

Segment 

Segment 

Segment 

Segment 


Accumulator 
Base 
Counter 
Data . 

Source index 
Destination index 
Stack pointer 
Base pointer 
Code segment 
Data segment 
Stack segment 
Extra segment 
Instruction pointer 
Operation flags 
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by the^'o^ «•«. and DX) on also be addressed 

up the word register AX. The H and L indicam^ ^ ‘ he lndividual bytes that make 

Similarly, BH and BL form BX. 

The stack segment , h P ’ ^ “* and DL fo ™ "X 

fctg section. I unde^mL "*"» « discussed in ,he 

«088 instruction set introduced in the nc^er W ‘" '!*!? y ° U undt ' rMJn ‘ l the 
The flag register is the ° f ‘ h “ chap '" 

r-r d r 9 biB ,o si *"‘rsums e fl “^s^ a T'« 06 bi,$ >' bui ,he «** 

Sea, for differences in later processor ve4ilTsi P 22 ' " Prac ««>r Instmction 
or c eared based on the results of individual tons' Sh ° W "' abl<: U ' arc 


T^b uTl toe OJ , he 8086 /8088 

_ Bit uTe 1 


2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


Carry flag (CF) 

Parity flag (PF) 

Auxiliary cany flag (AF) 

Zero flag (ZF) 

Sign flag (SF) 

Trap flag (TF) 

Interrupt flag (IF) 
Direction flag (DF) 
Overflow flag (OF) 


Bits 


Notice from tabic 1.4 that only nine flaps 

I.}.5.and 12through 15 of thjregisteram in ‘ hena8re 8 is '" 

of course, he set to either 0 or I. A 0 indicates that the flae ” f ,h * ° ,her bi,s ca ". 
the flag is set. * 11 g dcar; a 1 ,nd »«»tes that 
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| he Fundamentals of Assembly language 


Certain assembly language instructions arc used to set or clear individual flags 
These instructions, often referred to as/lag and processor control instructions, are 
detailed shortly. Other instructions set or clear individual flags to indicate the result 
of a previous operation. For instance, the zero flag (ZF) is set if the result of an 
arithmetic operation is zero, and cleared if the result is not zero. 

A group of instructions referred to as control transfer instructions is used to 
test the value of the flags and then, based on the result, to transfer program control 
conditionally. To program effectively in assembly language, you must understand 
what the flags are and how they arc used. 


The Segment Registers 

The processors used m the IBM family of microcomputers have four segment 
registers for addressing: the code, data, extra, and stack segment registers. 

The code segment register fCS , concams the segment used with 
pointer register (IP) Thus. C S IP to,.tarns the segment and oflset ol 
instruction to be executed by the pr.uvNNor. 

operarons e h'can bemed aboTa se»nd^-gmen, regi«er for general-purpose 

data operations. . 

nr rt-oister (SS) is used as the reference segment for the stack 

and Just-dwidrthc stack pom.er (SP). Thus. SS.SP points ro rhe top of the stack, .he 

as? pla^ormat.on was stored in rhe stack segment. 

P mall routines for use from high-level languages, most 

When you “'nte small ddrcsses |n mJny instances, the code and data 

segment registers aresettothesa^ ^ ^ ^ ^ ^ „ y , hc 5 ubrou.ines ,s 

segments can be sc simplifies subroutine development Exceptions 

actually par. of the cod.n* h^^d data area, tn which case you can change 
occur when you wan, ro use ^ you need these registers ro pom, 

« «,——• “ “ 

program usually secs .he stack “^^^^^he siack was used prior 
routines Changing. he stack segment ^ luc of SP. <hc stack segment 

reach,ngyour subroutmeorw, ^ ^ (usu , ||y , -sys.em emsh"). 

register, can result in u 
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Chapter 1: Understanding the Programming Environment 


Additional Registers 


siartJo'w.nwh'''* ? csc " bcd so far available in every Inrel microprocessor, 

1 8088/8086 The 80286 (and the 80386 and 80486) include 

additional special-purpose registers. 


80286 Registers 

«doha^l^‘ tl0n u, re8lSlCrS UScd thc 80286 microprocessor Include the 
£****■« *** (GDT) regi5tcr * ** descriptor table (IDT) re Jster 

r^tr ptor ,h ' «<** -rd oSnjsfs 

These additional registers are used only when programming for protected 
2? 1 2“ «» cannot operate in proceed mode fai ^o«m 

m<X) '?'"* 80286 >’ T°“ « -,4 m 

, ^7 * Typically, they arc used in such system software as DOS 

encoders, which enable general programming in pro,ec,e7mode 


80386 and 80486 Registers 


Unlike the*r l*-bit and 16-bit predecessors, the 80386 and 80486 are aa k*. 
mlcroprocessors. N ^he registers In the 80386 and 80486 reflect thte enlL^d 
wweture. Both processors stiU use the same general-purpose registers as the wSa 
8088 “ d **« 80286 WBX.CX.and DX). bu, die regist^T^rou^^ 
are addressed by using the £ (extended) prefix. EAX, EBX, ECX, and EDX are 32-hii 
general-purpose registers. Without the E, only the lower 16 bits ofearh - ^ 
accessed. Using the traditional AL, AH, BL, BH cC oT dl or DH o ^ ** 

® <H>K chunks of dte lower 16 Wo of the re^sttr, DL “ D» gives you acres, 

° fthc£ preftt *° deno “ 52-bit register size applies also to other 
ttndESP, respectively 1 ”*' SUCh “ S ‘‘ “• and SP ' whlch b « om ' EBP. ESI. EDI, 

F^nd CS segment registers (also 16-bio wide), which operate the same as the ES 
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Fan 1: The Fundamentals of Assembly bmguagc 


Interrupts 


Frequently, a computer is called on to do many things at once For instance, 
your computer may need to accept input from the keyboard, update the video 
screen, write information to disk, and print a report—all at the same time. This sort 
of processing is not unusual. 

How does the computer do so many things simultaneously? In one method 
polling —the operating system repeatedly checks everything it needs to check. The 
other method relies on interrupts to indicate when a task needs to be addressed. 
Perhaps an illustration is in order. 


Suppose that you are the computer, and that you have half a dozen friends with 
whom you need to work. From time to time they have information to give you and 
you have things to tell them. If you operate by polling, you contact each friend at a 
set interval to see whether they need you and to give them any pending information. 
You may need to contact them every hour, or even every five minutes if you don t 
want to risk missing any information. Clearly, this can quickly become wasteful—you 
end up doing virtually nothing but call your friends repeatedly. 

If you are operating in an interrupt-driven fashion, however, you give informa¬ 
tion to a friend only when you have some to give, and you receive information only 
when your friend calls you. Thus, you spend less time making repeated contacts and 
more time doing other tasks. This method is much more efficient. 

Your computer uses interrupts in the same manner. When you press a key <c 
the keyboard, you generate an interrupt that tells the computer a key has been 
pressed. The interrupt grabs the computer's attention so that the keypress can 

processed. 


The two rvpes of interrupts arc hardware interrupts and software interrupts^ 
The keypress, an example of a hardware interrupt, is generated by a piece of 
hardware (the keyboard). A software interrupt is one meant to be called to perfonn 
a standardized task. The DIOS and DOS services are accessed by way of software 

interrupts. 


BIOS Services 


Hie BIOS is a collection of low-level routines used for communicating with the 
computer hardware. This collection isItnown as the Basic Input/Outpu ys em, or 
BIOS for short Because the BIOS software usually is comainedin the computer s 
read-only memory (ROM), BIOS is often referred to as ROM-BJOS. 
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ing Environment 


program (such «o"nc you ma^wfop) W t '“ ily accessible «° an outside 

interrupts, are nothing more than cahlble s ^'^- ,nvokcd “ftware 

levels has definhe'benefiu rhJ OS mtrod “ ccs bc,w ecn the hardware and software 
because software develoDment Pnmary bencf,t should be immediately apparent- 
software more efficiently Brra ,mc ,s * rcai,y en hanced, programmers can develop 
interface for every oossible ^ 1 ° ^ B,os . you don't have to develop a different 
security of knoZ, Zvour ", ^ T bination * °' h - benefits include the 

rations! 8 V software Wl11 w ork on a variety of hardware configu- 

by arc n,dim '"“'* ‘ he - of-ta performed 

** “ d - *■—- 


DOS Services 


progra™^.^ b“u mvXthcs'e'Latent 

what fa^ropde^b^BIOS* ta^act^fhe^DolfUnctions rely'extensivel^o^di^BIOv 
“I ifyOU ““ 1 ° OS fUnC,i ° n ' “ -* tum use a BIOS funcUon 

ter2V^cessingDOSSenricM*" lhrOUR J’ OUI * b * book and arc detailed Cha„ 


Device Drivers 

DOS enables you to add capabilities that may be unique to your particular 
computer setup. To add such capabilities, you use device driver*, specal pm^ms 
loaded right after DOS is started. The device drivers are appended to DOS^hey 
enable your programs to communicate with and control special devices. ’ ” 

For instance, many people have a mouse attached to their computer This 
device is not a standard pan of a computer, at least not as far as DOS is concerned 
Thus, you can use a device driver called MOUSE SYS to let DOS know that you have 
a mouse. Because the device dnver becomes an extension to DOS. your programs 
can take advantage of the mouse by using additional software interrupts. Device 
dnvers such as MOUSE.SYS typically are provided by the manufacturer of the device. 
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Summary 


Unde R ^ 

^ ,o un<ient ^ ,o 

within the environment include the following. 

□ Memory use 

□ The stack . 

□ CPU registers and flags 
Q Interrupts 

□ BIOS and DOS services 

Each of these items is introduced and discussed in this chapter. lklb-JJ- b * d 
£ro*ne^ary if you are to Assorts the information in .he ms. of the boot 

The next chapter Introduces you to programming in assembly language. 


\ 
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CHAPTER 



An Overview of 
Assembly Language 

B efore you can begin 10 use assembly language to Its fullest potential, you must 
start with the basics. This chapter presents a quick introduction to assembly 
language, not an exhaustive discussion of assembly language programs It is meant 
to touch on the structure, main commands, and operations of the language. The 
informal! yn presented in this chapter will help you as you apply the concepts and 
examples discuss* d in the rest of the book. 

If you have not read Chapter 1 , "Understanding the Programming Environ¬ 
ment," you probably should do so before reading this chapter. The concepts covered 
In that chapter are important to an understanding of the assembly lan gu a ge. prr . 
sented in this chapter. 

Conceptual Guide 
to Assembly Language 

Assembly language is similar to many other computer languages. At their root, 
languages provide building blocks the programmer can arrange to create programs. 
The building blocks in assembly language are smaller than those in high-level 
languages. 


29 

Scanned by CamScanner 



30 


Part I: The Fundamc 


ntals of Assembly Language 


The building block concept should already be familiar to you. You program by 
using commands, variables, and words that arc almost like English to instruct the 
computer what to do. These words are translated into machine code, a series of 
numbers the computer understands. But the work appears to be done with the 
building blocks, not with the numbers used by the computer. 

Because the building blocks used in assembly language are smaller than those 
in high-level languages, they are individually less powerful. Because each building 
block, dr command, does less, more commands are necessary to perform a given 
task. 

Typically, if you program solely in a high-level language, you don’t need to be 
directly concerned with operations that occur “behind the scenes." For instance, you 
usually do not need to even think about where and bow your data will reside in the 
computer’s memory. These matters are arranged by the compiler or by the run-time 
system used by your language. A run-time system is a manager that oversees program 
execution. 

Another example of these “behind the scenes" operations is the use of what I 
call compound commands. For instance, consider the BASIC statement 

PRINT “This is a test* 

Pascal uses the following syntax to accomplish the same task: 
writeln('This is a test'); 

C uses this syntax: 

printf(’This is a test\n’); 

All of these statements accomplish the same task. They print to the output 
device (usually the display monitor) a string of characters followed bya carriage 
return and line feed. Inherent in the PRINT,writeln( ), and printf () commands, 
however, are several smaller commands that do other tasks related to the display of 
information. These smaller commands locate the information to be displayed, 
determine where to display it, decide how to display the information, and handle the 
carriage return and line feed at the end of the string. 

With assembly language, very little happens “behind the scenes. You must 
specify virtually everything related to the composition, storage, and execution o 
your program or subroutine. For example, if you want to perform the equi ent o 
printing a string in assembly language, the following lines accomplish t e tas . 



MOV 

DX,OFFSET MSG 


MOV 

AH,C9h 


INT 

21h 

.’•SG 

DO 

'This is a test',13,10, 
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Wo" * s tZZ K ' r elCmen,S k0vtrid la,er «M» book) must be- added 

K eXCCU : C "' "*«^n.pl e clearly indicates how extremely 

. Srev“;tiZ; ; B k n * oe,nb, >:«*«*» 

.han you would with a h’gMetl I.Z B ^ " U ’ emUChmo —<*“* 

declaredZpUc^I^Zu^ZccLcomcdi' ‘’'"T* ' hiS example: daa "»*» be 
to Change your habits much BASIC ° WOrk,n R in Pascal or C, you will not have 
explicitly declaring data eicmenr i C pr ° grammers - however, must get used to 
»nd manipulated in assembly language" P ‘ Cr diSCUSSCS h ° W da,a * defined 

It enables you to instromhe! com*' 1 ?*' '* lh ' samc “ in V other computer language: 
background, however^'yo^Zy 'fmZZZ'T S P ec ‘^ ct ' LS * ts Depending on ytfur 
different. r Y r,nd ,he W-canon of the concepts radically 

level languages. * Similar ‘° ,hat for man >' high- 

Q Source-code generation or editing 
Q Assembly 
Q Linking 
O Execution 

CunUiar The second step"(ZZbly) ,s anatogoul'!' 1 "t ?"' ,hisprocess wi M seem 
level language development The third sten if v t0 , th * com P ,lation «cp of high. 

u** ^h-U*’ assembly languagc'development ptoM^Zs diffe"^/ 0 ' 1 curre " d >' 

most high-level language programmers currendy^ZonT^erem from the steps 

Assembly Language Structure 

figured out the basic structure forassembly ilangu^eproMmm U T* “‘T'*’' haVe 
IS the basic Structure: X 8 gepro 8ramming lines. If not, here 

Label Operator Operands ;Comments 

There are no hard and fast spacing rules other »h™ »i. * 
each element of the coding line with at kfast one space or tab chi ^ T Xfmtc 
every pan of the program line is optional. You don’t need a laheTr MS °' almosl 

oneordec, de, ha, one is necessary) IXpeotlingonthcopeZo^^o” 
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. m-,v not need operands. And comments are always optional. In fact your 
^’rlm line does not even need an instruction. It can consist simply of a label or 
comments. How you structure the line is entirely up to you. 

as vou work through the examples in this book, each element of an assembly 

program lines is discussed in detail in Chapter 3 , Choos ng 
Assembler." 

The Assembly Language 
Instruction Set 


8M&M88. and the upward con.panb.il* o SMMOM code Ote^ ^ 
specific assembly language instruenons .n this book focus on tne ou - 

set. All assembly language examples in this 
_ ._— .„~Lr .ten nn rnmDUterS that U 


r U1 OV/UU/OWv --*- 

s in this book focus on the 8086 

“s^e assembicr ukes cue of dte nansUdon into machine langur 

While this may seem a fonnidable number of “^lof'^ms^rtons ate 
u-s noTL bad as 1. sounds Most of the mtoocom- 

numberof 

L £e 80286.80386. 80486.8087.80287, and 80587. ^ 

Table 2.1 fisc dte dlffeten, classes of ^^^cmn- Stoups, 
808&8088. Notice that the instructions are individual 

depending on the ty^e of operauon petfonned Also us 
asscmbly'bnguage insmtetions that form each group. 
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Table 2.1. 


Tbc^ S0S6, H08H m icroprocessor instruction set 


Data Transfer Instructions 


IN 

Input from port 

LAHF 

I.oad AH register with flags 

LOS 

l oad DS register 

LEA 

Load effective address 

LES 

Load F.S register 

MOV 

Move 

OUT 

Output to port 

POP 

Remove data from stack 

POPF 

Remove flags from stack 

PUSH 

Place data on stack 

PUSHF 

Place flags on stack 

SAHF 

Store AH into flag register 

XCHG 

Exchange 

XL AT 

Translate 


Arithmetic Instrut 

AAA 

ASCII adjust for addition 

AAD 

ASCII adjust for division 

AAM 

ASCII adjust for multiplication 

AAS 

ASCII adjust for subtraction 

ADC 

Add with carry 

ADD 

Add 

CBW 

Convert byte to word 

CMP 

Compare 

CWD 

Convert word to doubleword 

DAA 

Decimal adjust for addition 

OAS 

Decimal adjust for subtraction 

DEC 

Decrement by 1 

OIV 

Divide, unsigned 

IDIV 

Integer divide 

IMUL 

Integer multiply 

INC 

Increment by 1 

MUL 

Multiply 


continues 
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NEG Negate 

SBB Subtract with carry 

SUB Subtract 


AND 

NOT 

OR 

RCL 

RCR 

ROL 

ROR 

SAL 

SAR 

SHL 

SHR 

TEST 

XOR 

CMPSB 

CMPSW 

LOOSB 

LODSW 

MOVSB 

MOVSW 

REP 

REPE 

REPNE 

RFPNZ 

RfPZ • 

SCASP 

SCASW 

S’OCB 

£ TC 


Bit-Manipulation Instructions 

logical AND on bits 
Logical NOT on bits 
Logical OR on bits 
Rotate left through carry 
Rotate right through carry 
Rotate left 
Rotate right 
Arithmetic shift left 
Arithmetic shift right 
Shift left 
Shift right 
Test bits 

Logical cxclusive-or on bits 

String-Manipulation Instructions 

Compare strings, byte for byte 
Compare strings, word for word 
Load a byte from string into AL 
Load a word from string into AX 
Move string, byte by byte 
Move string, word by word 
Repeat 

Repeat if equal 
Repeat if not equal 
Repeat if not zero 
Repeat if zero 
Sean siring for byte 
S«..m ring i >f word 
Store hy*c 111 >1 string 
Store word in A\ at string 
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Chapter 2 An Ov erview of Assembly Language 


Control Transfer Instructions 


CALL 

Perform subroutine 

JNT 

Software Interrupt 

INTO 

Interrupt on overflow 

IRET 

Return from interrupt 

JA 

Jump if above 

JAE 

Jump if above or equal 

JB 

Jump if below 

JBE 

Jump if below or equal 

JC 

Jump on cany 

JCXZ 

Jump If CX=0 

JE 

Jump if equal 

JQ 

Jump if greater than 

JOE 

Jump if greater than or equal 

JL 

Jump if less than 

JLE 

Jump if less than or equal 

JMP 

• Jump 

JNA 

Jump if not above 

JNAE 

Jump if not above or equal 

JNB 

Jump if not below 

JNBE 

Jump if not below or equal 

JNC 

Jump on no carry 

JNE 

Jump if not equal 

JNG 

Jump if not greater than 

JNGE 

Jump if not greater than or equal 

JNL 

Jump if not less than 

JNLE 

Jump if not less than or equal 

JNO 

Jump on no overflow 

JNP 

Jump on no parity 

JNS 

Jump on not sign 

JNZ 

Jump on not zero 

JO 

Jump on overflow 

JP 

Jump on parity 

JPE 

Jump on parity even 

JPO 

Jump on parity odd 


Conti nur< 
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Table 2.1. 

JS 

continued ___ 

Jump on sign 


J7 

Jump on zero 


LOOP 

Loop 


• OOPE 

Loop while equal 


100PNE 

Loop while not equal 


loopnz 

Loop while not zero 


loopz 

Loop while zero 


RET 

Return from subroutine 



Flag- and Processor-Control Instructions 


CLC 

Clear carry flag 


CLD 

Clear direction flag 


CLI 

Clear Interrupt flag 


CMC 

Complement carry flag 


ESC 

Escape 


HLT 

Halt 


LOCK 

Lock bus 


NOP 

No operation 


STC 

Set carry flag 


STO 

Set direction flag 


STI 

WAIT 

Set interrupt flag 

_Wait_'___- 



Although able 2 1 lists quite a lo t* dtSercn. in this 

overly concerned. Some mnemonics, although ** y j^ J|incei j Z and JE test .he 
table, translate to the same machme language val ^ on , he con dition of those 
same flags and make the same b «" ch '"f dcc ^ e but mo re than one mnemonic is 
flags. They translate to the rumemach.nt code,° ^ context of the 

provided so that you can write code that is e sy 

task being done. « these Instructions in any depth, you 

Although this chapter does not d>scu the instructions affect the 

need to understand ~hal each instruetton does ano 


flaps and registers. 
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Assembly Language Directives 

point only. Each assembler addsir aSSCmb,y ,an 8uage instruction set as a beginning 
instruct the ass^^h™ r„ V™ ° f directivcs - "hose sole function is to 
file. ^ h ° W 10 80 about translating and processing the source-code 

of tlJsT dive’s 1 hive 2 been^d^d ^ dke ? a V avai,ab,c w »th MASM 6.0. Many 
direaives also have been^addrd ° 6; allcrnatc springs of earlier 

TASM 3.0, the assembler from Rn i 2-3 Sh ° WS lhc dircctivcs available with 

unique direct^ 41,(1 Intcrnational this instance, there are 214 



.186 
.286 
.286P 
.287 
.386 
• 386P 
.387 
.486 
.486P 
.8086 
.8087 
ALIGN 
.ALPHA 
ASSUME 
.BREAK 
BYTE 
CATSTR 
.CODE 
COMM 
COMMENT 
.CONST 
.CONTINUE 
.CREF 


.DATA 
•DATA? 
DB 
DO 
OF 

.DOSSEG 

DOSSES 

OQ 

DT 

DW 

DWORD 

ECHO 

.ELSE 

ELSE 

.ELSEIF 

ELSEIF 

ENO 

.ENDIF 

ENDIF 

ENOM 

ENDP 

ENDS 

.ENDW 

EQU 


.ERR 

.ERRB 

.ERROEF 

.ERRDIF 

.ERROIFI 

.ERRE 

.ERRIDN 

.ERRIDNI 

.ERRNB 

•ERRNDEF 

.ERRN2 

EVEN 

.EXIT 

EXITM 

EXTERN 

EXTERNDEF 

EXTRN 

.FAROATA 

•FARDATA? 

FOR 

FORC 

FWORO 

GOTO 

GROUP 


.IF 

IFDEF 

IFDIF 

IFDIFI 

IFE 

IFIDN 

IFIDNI 

IFIFB 

IFNB 

IFNOEF 

INCLUDE 

INCLUDELIB 

INSTR 

INVOKE 

IRP 

IRPC 

LABEL 

.LALL 

.LFCONO 

.LIST 

.LISTALL 

.LISTIF 

.LISTMACRO 

.LISTUACROALL 

confinin'! 
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Table 2.2. continued _____ 

LOCAL 

PROC 

.SALI. 

TBYTE 

MACRO 

PROTO 

SBYTE 

TEXTEQU 

MODEL 

PUBLIC 

SDWORD 

.TFCONO 

NAME 

PURGE 

SEGMENT.SEQ 

TITLE 

, N087 

PUSHCONTEXT 

.SECOND 

TYPEDEF 

.NOCREF 

DWORD 

SIZESTR 

UNION 

.NOLISV 

.RADIX 

.STACK 

.UNTIL 

.NOLISTIF 

REAL4 

.STARTUP 

•UNTILCXZ 

.nolistmacro 

REALS 

STRUC 

•WHILE 

OPTION 

REAL 10 

STRUCT 

WHILE 

ORG 

RECORO 

SUBSTR 

WORD 

%OUT 

.REPEAT 

SUBTITLE 

• XALL 

PAGE 

REPEAT 

SUBTTL 

•XCREF 

POPCONTEXT 

REPT 

SWORD 

•XLIST 


Table 2.3 . TASM 3 0 directive list. _- 

.r>r HAT A ENDIF 



ARG 

.DATA 

.186 

ASSUME 

.DATA? 

.286 

\BIN 

DATASEG 

.286C 

CATSTR 

DB 

.286P 

.CODE 

DD 

.287 

CODESEG 

WDEPTH 

.386 

COMM 

DF 

.386C 

COMMENT 

DISPLAY 

.386P 

\CONDS 

DOSSEG 

.387 

.CONST 

DP 

.486 

CONST 

DQ 

. 486C 

.CREF 

DT 

.486P 

%CREF 

DW 

.8686 

\CREFALL 

ELSE 

.8087 

ACREFREF 

ELSEIF 

ALIGN 

\CREFUREF 

EHUL 

.ALPHA 

\CTLS 

END 


ENOU 

ENDP 

ENOS 

ENUM 

EQU 

.ERR 

ERR 

.ERR1 

.ERR2 

.ERRB 

.ERRDEF 

.ERROIF 

.ERRDIFI 

.ERRE 

.ERRIDN 

.ERRIDNI 


Scanned by CamScanner 



ERRIF 

IFIONI 

ERRIF1 

IFNB 

ERRIF2 

ifndef 

ERRIFB 

'INCL 

errifdef 

INCLUDE 

errifdif 

INCLUOELIB 

errifoifi 

INSTR 

errife 

IRP 

errifidn 

IRPC 

LRRIFIDNI 

JUMPS 

errifnb 

LABEL 

errifnoef 

• LALL 

.errnb 

largesta -« 

. ERRNL>tF 

.LFCO'IO 

.ERRNZ 

'LINCU 

EVEN 

%LIST 

EVENDATA 

.LIST 

.EXIT 

LOCAL 

EXITCODE 

LOCALS 

EX ITU 

MACRO 

EXTRN 

HMACS 

.FARDATA 

MASM 

.FARDATA? 

MASU51 

FAROATA 

.MODEL 

GLOBAL 

MOOEL 

GOTO 

MULTERRS 

GROUP 

NAME 

IDEAL 

VJEWPAGE 

IF 

'NOCONDS 

IF1 

'NOCREF 

IF2 

\NOCTLS 

IFB 

NOEMUL 

IFDEF 

'NOINCl 

IF C I c 

NOJUMPS 

] c n t c • 

'NOLIST 

IFE 

NOLOCALS 

IF ION 

'NOMACS 


NOMASM51 

SALL 

NOMULTERRS 

SEGMENT 

NOSMART 

• SEQ 

'NOSYMS 

SEO 

'NOTRUNC 

.SFCOND 

nowarn 

SIZESTR 

ORG 

SMALLSTACK 

%OUT 

SMART 

P186 

.STACK 

P286 

STACK 

P 2B6N 

.STARTUP 

P286P 

startupcooe 

P287 

STRUC 

P386 

SUBSTR 

P3 r >6N 

SUBTTL 

P386P 

%SUBTTL 

P387 

%SYMS 

P486 

TABLE 

P486N 

'tabsize 

P8086 

tblptr 

P8087 

%TEXT 

PAGE 

•TFCONO 

'PAGESIZE 

title 

%PCNT 

'TITLE 

PN087 

'TRUNC 

'POPLCTL 

typedef 

PROC 

UDATASEG 

PUBLIC 

ufardata 

PUBLICDLL 

UNION 

PURGE 

USES 

%PU$HLCTL 

VERSION 

quirks 

WARN 

•RADIX 

Y/H'lF 

RADIX 



• * ALL 

RECORD 

. A Ai • 

REPT 

•XLIJT 
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execute Rathe r. when an *** This chaD(er shows you how to use some of these 
"* ws * n a h ^uUrMhmVu S b fd for defining dma Each directive shown in lable 2 2 
ancT^.fns' explained in^letail a,so in Chap*, 23. ^ DireC.ves’ 


Data Storage in Memory 

Data is stored in the computer s memory as a series ofL^ mVc 

-Understanding the /J^Xan Address Up to 640K of memory This work area 

operating under DOS no • . . p •> snecific individual value. 

* isn hvtes each of which can store a specuit, i»u‘» ,uu " 

Dccau«: each tnae'fsmad^up of 8 bits, and each bit can have a value of 0 or 1. each 

byte can store a value in the range of 0 through 2^ 

or-im ;n assembly language and then assemble and link the programs 
Asvouprog nfsvntacticallv correct* are translated into individual 

r » .««*» «**•• t ° *■ 

bytes of informs. l between machine language program 

computer, no ,ih m. . I procramm er. a distinction is vital toensure 

codingLes while the program is executing. 

s ,„ vr -l methods arc available tor setting aside data areas in an assembly 

i nor orouram l vnicallv. the task o done with special assembler directives, such 
language program r f (his chaptc r. The most common 

:,o. -* t.^**-. -*«*» *.. 

look at each of these mctmuls. iocusing first on equates. 


Equates 


Equates do not set aside a physical memory area 
uses equates ,* M.b>t.«u.c values later in the program, 
of equates can be used to define the IBM color set: 


for data Rather, the assembler 
For instance, the following set 


BLACK 

BLUE 

G3tFN 

CiAN 

BED 

MAGtMTA 


EGU ® 

EQU 1 

EO'J 2 

ECU 3 

ECU 4 

EQU 5 
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BROWN 

WHITE 

GRAY 

LT_BLUE 

LTJJREEN 

LT_CYAN 

LT_RED 

lt_uagenta 

YELLOW 

BRJSHITE 


EQU 

6 

EOU 

7 

EQU 

8 

EQU 

9 

EQU 

10 

EQU 

11 

EQU 

12 

EQU 

13 

CPU , 

14 

EQU 

15 


Ing th« four Is ^ USC ^ cmcmbcrin 8 bed is much easier than rcmember- 

JLlfl-IT . 1 ? T 1 ? +* c °'° f For example, although the following 
SIZ-* coona ^y *® le same * the first one is considerably easier for humans 


MOV 

MOV 


ah,lt_blue 

AH,9. 


^g ££££££ at'p«„r e ‘ S,er 


Data*Allocation Directives 

.. ,pice for *« d - 

the data-allocation direcUves for assembly language praams. 

Table 2 4 ■ Data-allocation directives am/ tbe ir meanings. 

Meaning 


BYTE or 06 
WORD or OM 
DWORD or DO 
DWORD or DQ 
TBYTE or DT 
SBYTE 
SWORD 


Define an unsigned byte (1 byte) 

Define an unsigned word (2 bytes) 

Define an unsigned doubleword (4 bytes) 
Define an unsigned quadword (8 bytes) 

Define 10 bytes (10 bytes) * 

Define a signed byte (1 byte) 

Define a signed word (2 bytes) 


CTHiUnuet 
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Table 2.4. continued 


Directive Meaning 


uireLiive 

SDWORD 

Define a signed doubleword (4 bytes) 

FWORD 

Define six bytes (6 bytes) 

REAL4 

Define a single-precision floating-point number 


(4 bytes) 

REALS 

Define a double-precision floating-point number 


(8 bytes) 

REAL10 

Define a 10-byte floating-point number (10 bytes) 


Note that not all the data-allocation directives shown in table 2.4 
in all assemblers.For instance, the SByte, SWORD, and SDWORD directives 
MASM 6.0; they are not available in previous versions. Sum ar j\ p " vl °* l$ DT 
of MASM did not allow you to use the alternate directives or , • • ’ ' 

Althoueh the examples in this book use the more universal nomenclature of 00, m, 
rrfnd ox. you should be aware that if you have MASM 6.0 you can use the 

alternate directives. 

Each data-allocation directive sets aside memory for subsequent use by ymir 
program. These directives can be further modified and 

through the use of the OUR and OFFSET operators. u nders.andmghow*esed,recuves 

function may be easier if you see how they are used in a program. Look 
following selected data declarations in a program. 


> 


0RIG_DRIVE 

0B 

00 

0RIG_PATH 

DB 

64 OUP(0) 

PRE_PATH 

DR 

*\* 

PATH 

0B 

64 OUP(0) 

ANY_F1LE 

DB 

••.*‘,0 ' 

DIR_TABLE 

0B 

256 0UP(19 OUP(0)) 

BREAK_INT_0FF 

DW 

00 

BREAK_INT_SEG 

ow 

00 

CMOTAGLE 

EQU 

THIS BYTE 


DW 

OFFSET ACTI0N_CUD 


DW 

OFFSET D0IT_CM0 


DW 

OFFSET DRIVE_CUD 
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, 

DW 

OFFSET PATH_CM0 


OVI 

OFFSET EXIT_CMD 

action_cmd 

DB 

'SELECT* ,0 

00IT_CM0 

DB 

'DELETE*,0 

ORIVE_CMD 

DB 

‘DRIVE*,0 

PATH_CMO 

OB 

1* 

'PATH*,0 

exit_cmd 

OB 

'EXIT*,0 

ONE MOMENT 

DB 

'Examining diskette 


One moment please!',0 


you canhur d '^ Ctivrs DB ’ DW ’ and EQU arc used here. If you are using MASM 6.0, 

n _ .'T , " e fcw U " es *** “ ,de and d e«ne a data area 5,084 bytes long. Further they 

T Ca 7, U “ r ** rcfcrcnced *>*™8 to «ch line by iu 
label, 111 desenbe what the data-allocation directives accomplish in this example. 

OftlGjnivE is defined as a variable one byte long, initially set to 0 OHIO path 

ValUeOf0; ,hr ° U8h UW ° f ,he DUP oP-lorhow^. “°- p P " H 

Site line 1 ' onx ™*' ««* can be referenced directly only as a 

byte value. For instance, the command 7 7 

MOV AH,ORIG_PATH 

° f ‘ he 64 ^ * *>“»« loaded 

MOV AX,0RIG_PATH 

b '” USe "" “ semblerdo ‘ s "°i allow 8 bits be loaded 

The following example shows how to override thk . c 

ORIG.PATH as byte values only: th,S dcdarcd rcfercnce to 

MOV AX,WORD PTR 0RIG_PATH 

The use of wro ptr tells the assembler that even though the label orig path is a 

WaM “ *» a. the'addness 

§ 

PRE PATH is similar to ORIG DRIVE eifrisnf k ■ . 

■he ASCII value of the baeblih chi^er «v ^ ^ “ bCi " 8 9Z - 

followingfourindividualby.es ,ranslltes dircc ">’ ” 

42 46 42 00 
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DIR_table becomes an area of zeros 256 • 19 (or 4,864 bytes) long. You can use 
the DUP operator multiple times in the same declaration to make it more readable. 

BREAK_INT_OFF and BREAK_INT_SEG set aside one word each and initially set the 
contents of those memory locations to zero. Later, the contents of these named 
memory locations can be loaded directly into a register by a line similar to the 
following: 

MOV AX,BREAK_INT_SEG 

Through the use of EQU and THIS BYTE, CMDJTABIE Is set up to reference the first 
byte of an area to be used later as an offset table to other values. For this example, 
the five words beginning at CUD_TABlE are set equal to the offset addresses of other 
variables. In this way, the messages ACTIO^CMO, DOIT^CMO, DRIVE.CMD, PATHJ3*), and 
EXIT CUD can all be accessed by address, even diough the length of each mes sage is 
different. 

Finally. ONEJJOUENT is a series of bytes that spells the message Exaaining 
diskette ... One moment please), followed by a zero, or null byte. 

The preceding example illustrates the moist commonly used data-allocation 
directives. (At least, they are the most common when you are writing assembly 
language subroutines or small utilities.) The concepts illustrated in the example, 
however, are equally applicable when you work with , the other data-allocation 
directives. 


Addressing 

The 8086/8088 offers a multitude of ways to address data: register-to-register, 
immediate addressing, direct addressing, and several types of indirect addressing: 
Because you will use each of these modes as you program, you need to understand 

them now. . , , ; . ... . - 1 •: 

Each addressing mode always has a source and a destination. The destination 
is always to the left of the comma, the source is always to the right. In addition, both 
direct and indirect addressing assume an implied addressing segment. Let s t a 
look at each type of addressing and any applicable segment-addressing assumptions. 


Register Addressing 


Register addressing is the fastest mode of data addressing. These instructions 
■ake fewer physical bytes and are executed entirely in iheCPU. Ifyouc dau needs are 
small within certain subroutines, always perform manipulations within regi. 
Some examples of this type of addressing are 
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MOV 

MOV 

MOV 


ax.bx 
OX, ex 

01, SI 


comma being e^^mo^e!' *" CO " tents of the agister to the right of the 

BX. CX, and SI are copied imo ^DX Tnd ° f lhe COmrna ™ us the contents of 
are copied, not simply moved TWfom' £ ’ 'V 9 ? 1 ™ 1 * Notice *»'he contents 
and BX contain the same values ’ ^ Cf the ,nstruct,on is completed, AX 


Immediate Addressing 


register or^mem^^ P<*ced imo a 

Ben r... 


RED 
L0C_1 
L0C2 


EQU 

DB 

0W 

MOV 

MOV 

MOV 

MOV 


4 
00 

0000 

AX,5 
BL.RED 
L0C_1,RED 
L °C_2,5 


specified destination (left of the^on ( <f‘° f ,he comma ) is **'"8 Placed at the 

tester or a memo™ Stio^ZTi , TL deStinatio " “ «*•>« a 

coding Ua^mbled^all'^ rcp '“" he «**» <he 

constant numeric value required by ^ Pr ° Wd ' ‘ h ' 


Direct Addressing 

re8is,er or * —T 

a renter to .memory iocatton.as ° rfr0m 

LOC 1" • ‘ - — 


IOC 2 


DB 

0W 


00 


»»V *L,L0C_1 I 
MOV BX,L0C_2 
MOV L0C_1,AH 
MOV L0C_2,CX 
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/Vs with the other addressing inodes, the values contained in the memory 
location or register to the right of the comma are copied into the memory location 
or register to the left of the comma. 


Indirect Addressing 

Indirect addressing is not only ihr most difficult addressing mode to master 
but also the most powerful. The three methods of indirect addressing are register 
indirect, indexed (or based), and based and indexed ujith displacement. Instead 
of considering each of these methods individually, this section covers the general 
category of indirect addressing as a whole. 

To illustrate the different indirect addressing methods, consider the following 


code fragments: 


CMD_TABLE 

EQU 

THIS BYTE 


DW 

OFFSET ACTION_CMD 


DW 

OFFSET D0IT_CMD 


DW 

OFFSET DRIVE_CMD 


ow 

OFFSET PATHCMD 


DW 

OFFSET EXIT_CMD 

ACTION_CMD 

D8 

•SELECT* ,0 

doit_cmd 

DB 

•DELETE*,0 

ORIVE_CMD 

DB 

•DRIVE*,0 

PATH_CMD 

DB 

* PATH *,0 

EXIT_CMD 

DB 

•EXIT*,0 

CMD_NUM 

ow 

0003 


MOV 

AX,CMD_NUM 


MOV 

BX,OFFSET CMD_TABLE 


SHL 

AX, 1 


ADO 

BX.AX 


MOV 

SI.IBXl 


Suppose that the variable CM0 _num contains the value 3 . The first instruction in 
this fragment uses direct addressing to copy the contents of CMDJttJM (3) mto 
Then immediate addressing is used to load BX with the offset address o ^ 

Remember that when this code is assembled, the 

replaced with a literal number that represents the desired offset address. The 
contents of AX are multiplied by 2 (which always happens when you shift die 
one position to the left), and this value is added to what ,s ahead) inBJC. Atth^pomt. 

BX contains a value 6 greater than the address of the start o 

address of the table entry for PATH_CMD. 
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Thcr fin | 

This«atem"m"? s ^ 

by BX. which is the address for the sir' "d ’ ,hecomcn ‘ s °fihe locationaddressed 
^ways assumes that BX com! ' T* ^ ,nd '™ ^dressing usage 

instruct the assembler iZTZ co l ™ V* bncta * < as uscd in — -Lple) 
register wuhin the brackets Onlv the ^ ° * hC mcmory ,oca “on pointed to by the 

brackets. ° n, y th * «*««* BX. BP, Si, or D1 may be used within 

always indicate i«idb^ddi^i^£ l JJ , | , c , “ d mt ° be,icvin 8 that the brackets 
for other purposes; in some ve” i ons ,he £° S0 ^ mblcr them be used also 
certain circumstances to obtain special rnrl™ trtvcn requires their use under 
covered in greater detail in Chapter 3 wh * °k addrcssin 8 ? Th* topic is 

Popular assemblers are examined^ 3 ' * * hC d,ffcrences between the most 

used P""*'™- ^ indirect addressing is 

changing the number in CMD num i n this inltT* T ^ ,d * ded im ° SI ^P'y by 


MOV 

MOV 

MOV 


SI,[BX] 

SI,[BP+2] 

A*. [BX+SI + 2] 


The first instruction show« rK- i~a 

second and third examples, howeve^show^ 551 " 8 m f thod airead y described. The 
uses the base register and a displacement '' ana,,ons The second example 

the base register, producing a Th ‘° "* —ents'of 

value to be copied 10 the destination be the addr «s of the source 

The third example uses the base register ^ 

value, ail of which are added together resulting *" deX '*8 ister ' anda displacement 
. « address of the soutce value from which the £££ ^‘ S e “ SUm ' d *° 

destination canbe ^w^d^'witiTeach ofdie other^d 0 *^*^ 1 * °^ dle sour ce and 
MOV l0x)iSI the other addressing schemes. Thus: 

UOV |BP^2|,SI 

M0V [BX*SI*2],AX 

are all perfectly accepuble as destinations for data. 


47 
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Segment Assumptions 

W-ben addressing data, the destination and source are always assumed to be in 
, nr r H ative lo the DS register The exception to this assumption is 

wherTthe base pointer. DP, is used as the base register in indirect addressing; in this 

instance the stack segment, SS, is used. 

The default segment can be overridden by explicit use of the desired segment. 


as follows: 

• . * • 

MOV 

CS:L0C_2,5 

MOV 

AL,CS:L0CJ 

MOV 

CS:L0C_2,CX 

MOV 

Sl,ES:lBXl 

MOV 

OS:1BP*2),SI 

MOV 

ES:[BX+SI+21,AX 


Notice that in the fifth line of these examples, DS must be stated explicidy as 
an override segment because the BP register is being used as the base register. 
Normally, SS would be assumed, but in this case DS is used. 


Looping and Branching 

A programming language’s most powerful capability may be that of repeating 
a series of instructions a specific number of times. Assembly language is no d^ren 
than other languages in this regard. Specific commands enable you to frraru* 
(transfer execution to a new location) and to loop (repeat a task in a controlled 

manner). 

If you look back at table 2.1, notice the section labeled Control Transfer 
Instructions. These are the individual assembly language instructions that control 

the flow of the program. 

in the basic 8086/8088 instruction set, 4 2 instructions 
which a program is executed. Each of these instructions (except CALL. I WT, I^T. d . 
and ret) is conditional. That is, the Instructions branch only If a certain condi 
met. Consider the following program fragment: 


MOV 

AH,03h 

• 

• 

I NT 

ion 


CMP 

DH.5 

• 

9 

JNE 

not_there 

• 

9 

MOV 

OH,6 

• 

MOV 

AH,02h 

• 


get current cursor position 
on row 57 

no, so skip following code 
set to row 6 

set current cursor position 
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ALARM: 


NOTJTHERE: 


INT 

MOV 

MOV 

MOV 

INT 

LOOP 

JMP 


lOh 

CX, (33h 
AH,02h 
PL. 7 
2lh 
ALARM 
DONE 


loop control 
output cnaractcr 
sensing BEL character 

do it again 


arennnrrmH , mp eu5e * fourcontr °l transfer instructions. Two of them (INT and JMP) 

and LOOP! art* "^h * e , actlon 15 takcn n S ht :,wa > The other two instructions (JNE 

the nriVn COnd,t,onal ,n ,he of JNE. the branch is taken only if the result of 
comooMnH C ° mpar,son is nonier o The second conditional instruction, LOOP, is a 

execution islrantf* 10 "^ * hC Va * Ue CX bcinp decremcnted . after which 

on is transferred to the address represented by the label ALARM. 

used JxTe°n U ef < ? Ul ,4 hC eXamp,CS thiS b °° k - ,00pinp and bra ^hing commands arc 
fnr fh V °" >OU USC lhcm is up fo > our Pagination, but you should try 

aod branches SI me,h ° d ° f ~’ " you Include ma 

nches, your program may be difficult to understand and maintain later. 


Segments and Classes 

As you learned in Chapter 1 . the IBM family of microcomputers uses processor, 
that address memory by using segmc.it addresses and offset addresses When you 

foTno m th n 3SSCm V ,JngUaRe Scpmcnt addresses ar~ set cither expUcitly^y 
loading the segment registers, or implicitly, through assembler directives to the 

But there are segment addresses-and then there arc segments So far I I™ 
talked about segment addresses and how they are used This definirion « t k / ^ > 
use of the word segment for the Intel family of microprocessors T * el ° 8,cal 
effectively in assembly language, you must understand these segments and 

Another definition of the word segment hnnw, , 

■ ; -*.. 

When you write assembly language source code, a seem*,, i. ___ 

of instructions that operate relative to the same segment ZT ’T? y * r ° up 
difficult not to confuse such/>rc$rarn segments with memory segments " ** 

directly related A program segment is just a block of code 
starting and e nding points To avoid confusion, some assembler, cat 1 ^ 

sections PSECTs (for program sections) raiher ih.n segment, “*** COd,n * 
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Ac the beginning of any group of instructions (usually at the beginning of the 
code in the file), the assembler directive SEGMENT is used to signify the start of a 
segment. At the close of the group of instructions, the ENDS directive is used. The 
assembler and linker then use these directives to delineate the explicit start and end 
of groups of assembly language code. 

The following example shows how the SEGMENT and ENDS directives might be 
used in an assembly language file: 

TEXT SEGMENT BYTE PUBLIC •CODE* 

assembly language coding goes in this area 
TEXT ENDS 

Let’s look at each pan of this example. The word TEXT is the name of the 
se Tfnent (this is a completely arbitrary name). Notice also the corresponding 
appearance of the name TEXT with the ENDS directive. 

The word byte directs the assembler to place this segment at the next available 
byte in the object file. In the example, BYTE is the align type of the segment. A seg¬ 
ment can be aligned to a byte, word, paragraph, or page. BYTE starts the segment at 
the byte following the end of the preceding segment. WORD begins the segment at 
the next even address. PARAgraph begins the segment at the next hexadecimal 
address that ends in a 0. PAGE begins the segment at the next hexadecimal address 
that ends in 00. Table 2.5 summarizes these align types. 


Table 2.5. Align types available with the Microsoft Assembler. 

Type 

Description 

BYTE 

Segment is placed at next available byte in object file. 

WORD 

Segment ic placed at next available even byte in object file. 

DWORD 

Segment is placed at next available doubleword address 
in object file. 

PARAGRAPH 

Segment is placed at next available paragraph boundary 
in object file; address of segment will end in a 0. 

PAGE 

-Segment is placed at next available page boundary in object 
file; address of segment will end in a 00. 


The word PUBLIC is a declaration of the segment’s combine type. The combine 
type, which is optional, denotes how a segment will be combined with other 
segments that have the same name. Several different combine types are available (sec 
table 2.6). The default combine type is PRIVATE. 
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— m ^ ine types available with the Microsoft Assembler and 


Linker. 



PUBLIC 


STACK 


COMMON 


MEMORY 

AT 


Results in no combining of segments, even if segments 
in other modules have the same name. 

Joins all segments with the same name into one segment 
when linked. All addresses and offsets in the resulting 
segment are relative to a single segment register. 

Joins all segments with this combine type to form one seg¬ 
ment when linked. All addresses and offsets in the resulting 
segment are relative to the stack segment register. The stack 
pointer (SP) register is initialized to the ending address of the 
segment. This combine type normally is used to define the 
stack area for a program. The linker requires that exactly one 
stack segment be defined for an EXE program. 

Same as PUBLIC, except that the segments are not joined to 
form a new, large segment. All common segments with the same 
name begin at the same point; the resulting segment is equal 
in length to the longest individual segment. 

Works exactly like the PUBLIC combine type. 

Used to prepare a template that will be used for acceding 
fixed location data. In the format at xxxx (where xxxx is a 
memory address), AT signifies that addresses and offsets are 
to be calculated relative to the specified memory- address. 


The word CODE is the segment’s class type. This name, which must be 
enclosed m single quotation marks, signifies the groupings to be used when the 
different segments are linked. All segments of a given class type are 1 ™h h 
contiguously in memory before another class type is beeun in^h. a oadcd 

example, the segment belongs to the 'CODE* class tvne and w n h C irectives 
other segments of the same class type. We >nd w,ll be grouped with 

by the high-level language you are using] is you ^h'seeTn eMrnplei^n late'r c^prers^ 
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Subroutines and Procedures 


Subroutines are essential to programs of any magnitude. They enable a 
programmer to break a task into smaller tasks, continuing to do so as necessary to 
complete a project. Using subroutines is much like outlining. You start with the 
main idea and break it down further and further until the entire topic is covered. 

A subroutine is basically the same as a procedure or function. Although some 
technical distinction may exist between subroutines, procedures, and functions, this 
book assumes that they are essentially the same. All of these terms describe coding 
developed to perform a specialized task or set of tasks, and called (either singular y 
or repetitive!)) from a higher-level controlling program. Because assembly language 
uses the terms procedure and proc to identify such an entity, so have I. 

In high-level languages, vou can easily define procedures that other programs 
can call BASIC uses the GOSJb command to invoke a subroutine and the RETURN 
command to -signal its end. Pascal, C, C+ + , and compiled BASIC enable you to call 
a procedure or function by using a user-defined name. In Pascal, control is 
subsequently returned to the calling program by use of the end marker; and in C or 
C+ + , the closing brace tor op' * nal return statement) marks the end of the function 


Because assemble language requires much more interaction on the 
programmer's part to accomplish a given task, and because the amount of source 
code written to accomplish the task can be prodigious, using procedures becomes 
even more important than with other languages. Two types of procedures (NEAR and 
FAR) are used in assemblv language. They are procedural^ the same, differing only 
in how a call to and RETum from each affects the stack and CSIP registers. 

near procedures are contained in the same code segment as the program 
invoking the procedure. The declaration of a near procedure is accomplished with 
the PROC NEAR directives. The following example shows a subroutine to load the AX 
register with the contents of the word to which DS:S1 points, after which SI is 
incremented to point to the next word. 


GET_WORD 


GET_WORD 


PROC 

MOV 

INC 

INC 

RET 

ENDP 


NEAR 

AX.ISI] 

SI 

SI 


This example is declared as a NEAR procedure becauser h 
segmen. as .he routine from which i. is called. The only change nccessa . 
this routine a FAR procedure is to change NEAR to FAR. 
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I he following line executes either a NEAR or FAR procedure- 
CALL get_word 


In the case of a near procedure, this invocation results in the offset address of the 

r^rrT^n {° lIowi,l & tht -‘ Call being pushed on the stack, and the address of 
l ~ RD ^ c ' n i> loa ded into the IP (thus, execution begins at GET_word). When the 
sequent RET is encountered, the value of the IP is retrieved from the stack, and 
execution continues from the point following the original CALL. 

Because this is a near routine, only offset addresses one word long are pushed 
on and subsequently popped from the stack. 


AR Procedure operates exactly the same way, except that two address words 
t e va ue o the code segment and the offset address) are pushed on and later 

poppe rom the stack. Also, both the CS and IP registers are set to point to the 
beginning of the subroutine. 

1 he vast majority of procedures you use will be of the NEAR persuasion. FAR 
procedures ordinarily are used for controlling programs, for extremely large 
programs, and for interrupt-handler routines. When you write routines to use with 
certain high-level languages, however, these languages require that your routines 
be defined as FAR procedures. 


The Assembly Language 
Subroutine Skeleton 

By this point, programmers who have done most of their work with high-level 
languages are usually shaking their heads in amazement and starting to visualize 
assembly language programmers in padded cells with small, barred windows. 

Don ’ 1 despair! All this information about memory usage, program organize 
tion, data storage, and procedures is necessary so that you can sec the structure and 
power of assembly language. The following statement may help simplify everythin* 
discussed on the last several pages: Virtually all assembly language programs and 
subroutines can be written using a standard program skeleton. Through the use of 

a program skeleton, you can concentrate on task completion rather than adminis¬ 
trative overhead. "" 


A program skeleton is a template that gives a bare-bones (pardon the pun) 
outline of the program header, data declaration areas, and other overhead- 
information. For example, most subroutines and COM files have data and code in 
the same memory segment. Thus, the following program skeleton can be entered 
saved as a file, and used as a starting point for future assembly language programs 
or subroutines: 
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Page 60,132 
Comment J 


File: (file name goes here] 

Author: (your name goes here) 

Date: (date program written] 

Purpose: (description of program or routine) 

Format: (syntax of calling statement] 

• ’ i 

; •** Public declaration of subroutines and data 

PUBLIC [list entry points and data here] 

; ••• External data needed by these subroutines 

EXTRN [data and its type goes here] 

; ••* External subroutines called by these subroutines 
EXTRN (routine and its type goes here) 

.MODEL (model information goes here] 


; •** Declaration of equates 


FALSE 

EQU 

-1 

TRUE 

EQU 

C 


* * * 

1 

Declaration of 
.DATA 

data 

0ATA1 

DW 

0000 

DATA2 

DW 

0000 

DAT A3 

DW 

0000 


; START OF MAIN CODING 


;These are sample equates. 

;Yours will vary according to 
;your needs. 


These are sample data 
definitions. Yours will vary. 
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f 


.CODE 

XXXXXX p R0C 


;Your program statements are 
;inserted at this point. 


XXXXXX 


ENDP 

ENO 


° <con } mcm l Gening into the habit of documenting your 

assembled, everythtnj^between ZSSZXg “ 
a commem block, is disregarded. Thus, .he comments you place 

and'mak Y > Ur P . r0grarn longer or slower; they lust increase the size of the source file 
and make it easier to understand later. source tile 

T ° define a block of comments, as is done near the beginning of this oroeram 
skeleton, use the comment directive followed by any character vou rh™ ^ 
should use a character that is not used elsewhere in your comment hi l.!??*** Y ° U 
the vertical bar (J). Everything between this character and the next occurrence of *his 
character is treated as a comment and disregarded by the assembler. 

In this program skeleton, information enclosed in bracket* « 
when the skeleton is developed into a real program Also the i ^ Supp,ied 

XXXXXX arc to be replaced with the name ofC^^? 
used to call this routine from other programs it is also the * * he name 

the program modules are put together '" S3ls0thcniun * ^ l«*eruseswhen 


How you use a program skeleton is up to vou vo.,r ^ 
habits and needs necessarily differ from everyone else’* tfvn ,v,dual Programming 

developed already, develop one and store it in a file Then ° ° not havc a skeleton 

edit the skeleton each time you start a new program y ° U Ca ° C °^ y 11,6 and 


Summary 


SSS ^^ic't. 'ompact and powerful. Bccauae 

c small, to create a program y 
a high-level language. Resulting progra ms 


blocks” provided by the language are small to W, " JU: * C thc “building 

quite a few more blocks than with » ’•—• ■ program you will need 
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however, can yield benefits—such as speed and compact code—not possible 
other languages. Other benefits are outlined in the introduction to this book. 


with 


This chapter is a quick overview of some features and basic tenets of the 
language. Detailed information on the use of individual instructions can be gleaned 
( om studying the examples through the test ol this book or by referring to Part IV, 

• KefiTence " 
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Choosing and Using 
Your Assembler 


T “I?'!!. 0 " " Drk Wilh assernbl >' la "8“>*e. you must have an assembler. 

several hi* M ? SM (Macro ASseMb,er ) “ probably the most widely known, but 
. c tcrnatIv es provide essentially complete compatibility with it Still 

other assemblers are quite different from the Microsoft version. 

To help you choose an assembler, this chapter lists brief summaries of the 
advantages and disadvantages of each But before gening Into the specifics of how 
any one assembler operates, let’s look at what all assemblers do. 


What an Assembler Does 

As the Introduction points out, an assembler is a program (hat translates 
susembly language instructions into machine language. In concept, the assembler’s 
I t iim P lc la translation process simply converts assembly language mnemonics 

pr °P er language code This 

rounds straightforward enough, but frequently it is not; determining what the 

Programmer wants can be tedious and tricky This translation or parsing process is 

what the assembler program spends the most time doing. 

rru 4 . !"*' ® a ^ lcs | sense of the word, an assembler does not fully translate source 
cooe into machine language. Rather, it creates an object code file, which by itself is 
executable. Although the assembler program parses and translates virtually 
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instruction some instructions cannot be encoded at this point, father, a 

sep^rat^^s^reQuired to translate the object file into an cxecutabk filc^(This step. 

S!ed linking, is covered in Chapter 4, “Choosing and Using Your Linker. ) 

To translate code, an assembler must read the source file a. leas. once. Each 

single-pass assembler (previous versions were jwo-p' )• ^ isnot discussed 

During the first pass, the assembler does the following: 


□ Parses the source code, calculating the offset for each line 

Q Makes assumptions about undefined values 

□ Does elementary error checking, displaying error messages if necessary 

Q Generates a preliminary listing file, if requested (no. all assembler! provide 
this action) 

During the final pass, which may also be the first pass, die assembler does the 


following: 

Q Attempts to reconcile the value assumptions made during previous passes 

□ Generates the final assembly listing (LST) file, if specified 

□ Generates die object code, storing it in the object (OBJ) file 
Q Generates the cross-reference (CRF) file, if specified 

□ Completes the error-checking process, displaying error messages if 
necessary 


The Leading Contenders 

The two leading assembler 

r M from TuZ^^ Another product from Microsoft, 

QuickAssembler, is available only with the QuickC package, ft uses a subset of the 
MASM capabilities. 

, _ nrnducts and see how they differ. Each has a few 
advamages^ncTeach Has a few problems; all are capable of excellent results. Your 
faial choice, of course, must be based on the features that are most important to you 
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continues 


59 


Scanned by CamScanner 



Pan I-. The Fundamentals of Assembly Language 


Table 3-1 .continued _ 

Directive MASM MASM MsQA TASM 

(Pseudooperation) 6.0 5.1 _ 2.51 3-0 


COMM 

COMMENT 

%CONDS 

.CONST 

CONST 

.CONTINUE 

.CREF 

HCREF 

VCREFALL 

\CREFREF 

%CREFUREF 

%CTLS 

.DATA 

.DATA? 

DATASEG 

DB 

DO 

*DEPTH 

OF 

DISPLAY 

.OOSSEG 

DOSSEG 

DP 

DO 

DT 

DW 

DWORD 

ECHO 

.ELSE 

ELSE 

.ELSE1F 


Y Y Y Y 

Y Y Y Y 

Y 

Y Y Y Y 

Y 



Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y Y 

Y 

Y Y Y 

Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y 

Y 

Y 

Y Y Y 

Y 


Y 

i 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 


TASM 

2J0 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 
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(Pseudooperation) 60 ^ \ L ^ M ^sQA TASM TASM 
-- ■-— >7 2 $1 3.0 2.0 


elseif 

euul 

END 

.ENDIF 

endif 

endm 

endp 

Enos 

.ENOW 

ENUM 

EOU 

.ERR 

ERR 

• ERR1 

• ERR2 
■ ERRfl 

.errdef 

.ERROIF 

•ERROIFI 

.erre 

.erridn 

’ERRIDNI 

errif 

errifi 

ERRIF2 

errifb 

errifdef 

errifdif 

errifoifi 

errife 

ERRIFION 

errifidni 


Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 
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Table 3■ l- continued 


Directive 

(Pseudooperation) 


MASM MASM MsQA tasm 
6.0 5.1 2.51 30 


TASM 

2.0 


errifnb 
errifndef 
.ERRNB 
.ERRNDEF 
.ERRNZ 
EVEN 

EVENDATA’ 

.EXIT 

EXITCODE 

EXITM 

EXTERN 

externdef 

EXTRN 

.FARDATA 

.FARDATA? 

FARDATA 

FOR 

FORC 

FWORD 

GLOBAL 

GOTO 

GROUP 

IDEAL 

• IF 

IF 

IF1 

IF2 

IFB 

IFDEF 

IFOIF 

IFDIFI 


Y Y Y 

Y Y Y 

Y Y Y 

Y Y Y 


Y 

Y Y Y 

Y 

Y 

Y Y Y 

Y Y Y 

Y Y Y 

Y 

Y 

Y 

Y 

Y Y Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y Y 
Y 

i Y 

Y Y 

Y Y 

Y Y 

Y Y 


Y Y 

Y Y 

Y Y 

Y Y 

Y Y 

Y Y 

Y Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 
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Directive 


( Pse udoop e rat j 0n ) ft o M MsQA TASM TASM 

Z -- - -—_ HI 30 2.o 


IFE 

ifidn 

ifidni 

IFNB 

ifndef 

%INCL 

INCLUDE 

includelib 

INSTR 
IRP ' 

I RPC 
INVOKE 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


JUMPS 
LABEL 
• LALL 

LARGESTACK 
.lfcond 
%linum 

%LIST 

.LIST 

•LISTALL 

.LISTIF 

•listmacro 

•CISTUACROALL 
LOCAL 

locals 

macro 

%MACS 

UASU 

MASM51 

.MODEL 

MOOEL 



Y Y 



Y 

Y 


Y 


Y Y 

Y Y 

Y Y 

Y . Y 

Y Y 

Y Y 

Y . Y 

Y Y 



wiforiirs 
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Table 3 I- continued 


Directive 
(Pseudooperation) 60 


MASM MASM MsQA TASM tasm 

5.1 2.51 30 2.0 



.nocref 

HNOCTL 

NOEMUL 

HNOINCL 

nojumps 

VIOLIST 

.NOLIST 

.NOLISTIF 

.NOLISTMACRO 

NOLOCALS 

ViOMACS 

NOMASM51 

NOMULTERRS 

nosuart 

HNOSYUS 
V40TRUNC 
NOWARN 

option 

0RG 

*OUT 

P186 

l’286 

F 266 N 


Y 


Y 

Y 

Y 


Y 

Y Y Y 

Y Y Y 
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P386N 

P386P 

P387 

P486 

P486N 

P8086 

P8087 

PAGE 

VAGESIZE 

%PCNT 

PN087 

POPCONTEXT 

%POPLCTL 

PROC 

PROTO 

PUBLIC 

PUBLICDLL 

PURGE 

PUSMCOMTEXT 

%PUSHLCTL 

QUIRKS 

DWORD 

.RADIX 

RADIX 

REAL4 

REALS 

REAL10 

RECORD 

.REPEAT 

REPEAT 


Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


\ 
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Table 31- continued 

Directive ’ MASM MASM 

(Pseudooperation) 6.0 5-1 


REPT 

.SALL- 


Y 

Y 


SBYTE 

Y 

SWORD 

Y 

SEGMENT 

Y 

.SEQ 

Y 

SEQ 

.SFCOND 

Y 

SIZESTR 

Y 

SMALLSTACK 

SMART 

.STACK 

Y 

STACK 

.STARTUP 

Y 

STARTUPCODE 

STRUC 

Y 

STRUCT 

Y 

SUBSTR 

Y 

SUBTITLE 

Y 

SUBTTl 

Y 

HSUBTTL 

HSYUS 

SWORD 

Y 

TABLE 

HTABSIZE 

TBLPTR 

TBYTE 

VTEXT 

TEXTEQU 

Y 

.TFCONO 

Y 

TITLE 

Y 


Y 

Y 


Y 

Y 


MsQA 

2J1 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 


TASM 

IS 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 


TASM 

2.0 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 


Y 

Y 


Y 

Y 


Y 

Y 
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Directive 


(Pseudooperation) ™ ™M 


%title 

VTRUNC 

TYPEDEF 

udataseg 

UFARDATA 

UNION 

.UNTIL 

•UNTILCX2 

USES 

VERSION 

WARN 

.WHILE 

WHILE 

WORD 

• XALL 

.XCREF 

.XLIST 


Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 


Y 

Y 

Y 


Y 

Y 

Y 

Y 

Y 


Y 

Y 

Y 


added directives. In most cases these are simply aliases f u qUC ’ 

nonunique directives, such as faroata lot .faroata. Such aliases Je need^d'h® 
cause in Turbo Assembler s ideal mode no directive can begin with a d ^ e 

the MASM standard world nearly half of the available directives do so. ^ 


MASM from Microsoft 

Microsoft’s MASM is one of the most popular assembler* for •>.< li i 

can .^~U‘ n ^ed^r mb ' er J h A' CraKS "'<*™ble object code. which 
collect cross^referencc'data^? < V° teculc ^jPP^ onalJ y •» can create listing flies and 
Sion 6, MASM was a two-pass asrembl^r ^ pmgnm Prior *° 
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Because MASM waseffectively the 

and was distributed by IBM, ‘fas become ihewn**ag MASM has 

measured. This is not to say that MASM is pcrt^Mn^ some 

borne a reputation for harboring strange bugs. Even in the latest V 

of MASM’s actions seem a bit bizarre to many users. 

Mos.of.he ttuebugs in earlier versions • s “ch“ f ^ re °fsomeof.hed..rc.u« 
,o do anything a. all, have been corrected m later i*^ b ^represents a 

has made one MASM version incompatible wj* the ^ design 

large departure from previous a dded. Indeed, program- 

structures reminiscient of features gu , v should have little trouble 

mers famiUar with C (particularly Microsoft’s C products) should have urn 

adapting to using MASM 6.0. 

Prior to MASM 6.0. one of .he bigges, d.sadvantagesof 

Utility to 'phase error’ problems MASM used this 'e™ >° "e 

" f ^ d —-^^^^^rrrmade this bug so 
references changed^™ undetected a , die point a. which i. occured, showing 

Cp only a. the firs, memory location that changed, which may have been many Irnes 

of code past the real error. 

If you do no. have MASM 6.0, the only practical way to find this, !dnd >fem.r 
is to ecnerate listings for both passes, then compare the two listings Un » 

, Zr ,he noVn. a. which die assigned memoir addresses fail to match. Careful 
elimination of the code generated by the instruction immediately prece mg e 
first mismatch usually shows what’s wrong 

m MASM 6.0, there is no such thingas a phase error, because MASM is no longer 
a two-pass compiler. 

Possibly the gate's, advantage 

set the standard and therefore usually includes at le^a offers full 

products lack. Another advantage is that its the only assc 

support for OS/2. 


QuickAssembler from Microsoft 

Microsoft's latest verion of QuickAssembler is version 2.51. It is available only 
as a parrofthc QuickC version 2.5 package, and runs only as pan of QuickC. 

QuickAssembler, a full implementation of 8086 assembly 
support of the 80386,80387. and OS/2 : prolcctedunodji featuresim MS ^ 

ihe QuickAssembler mani^U claims that QuickAssembler can use 
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MASM 5.1 direftivcs and 
listed in table 3.1. If you 
it is a bit difficult. 


operations, the manual itself describes only the directives 
cannot hnd out what a directive is supposed to do, using 


hiiv s greatest advantage is that it comes at no extra cost when you 

OulelrAcc^w 61 ^ ?° ,°^ e Q u ' c kC compiler This advantage is counterbalanced by 
nrohU m ^ Cr 5 ack of adcc * uate documentation, however. (The documentation 
problem is a flaw shared by all the Quick implementations, which depend a bit too 

on etr ypertext help system and thus fail to provide adequate printed 
Cr f^ cc da * a f° r serious users.) Another potentially serious drawback is 
yuicl^ssembler s lack of support for 80386, 80486, 80387, and protected mode 
OS/2 features. 

By default, QuickAssei.a vler is a single-pass assembler. This makes it faster than 
it otherwise would be (its speed on moderate-sized source flies is astounding) but 
P rcvents features such as program-listing generation from working. You can 
configure QuickAssembler to operate as a two-pass system; it then works much like 
MASM 5.1, but with a few added directives MASM 5.1 lacks. 

Because QuickAssembler normally is used only from inside the QuickC 
environment, and because it is so similar to MASM in all other respects, it is not 
discussed separately in the rest of this chapter. 


If you use QuickC, QuickAssembler is arguably the simplest way to ease into the 
world of assembly language; otherwise, you would do better with one of the sepa¬ 
rate products, if only because they offer better documentation than QuickAssembler. 


Turbo Assembler from Borland 

The other major competitor among assemblers is Borland’s Turbo Assembler 
(TASM). Turbo Assembler claims “100 percent” compatibility with full MASM, since 
the different versions of MASM are not compatible with each other, TASM is a useful 
tool when you must support several MASM versions. 

The unique Turbo Assembler feature that makes supporting several MASM 
versions possible is the availability of different assembly modes for existing assembly 
programs. To retain MASM compatibility, you have the option of using MASM, 
MASM51, or QUIRKS modes, either individually or in combination. 

For new programs in which you prefer that^he assembler not duplicate the 
sometimes bizarre actions of MASM but that it insteatj be completely consistent, you 
can set the mode to IDEAL. Because ideal mode js not compatible with the 
mainstream of assembly language programming, this book does not discuss the 
mode in detail. Although this capability certainly is a plus for Turbo Assembler, it 
should not be the deckling factor unless weighing other more critical advantages and 
disadvantages leaves you undecided. 
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Table 3 2 Urn .he condition, .ha. del ermine which MASM-compa.ible mode 
you should use and when. No.e .ha. .he defaul. operating mode .s MASM. 


Table 5.2. Turbo Assembler's 

conditions for selecting a MASM-compatible mode. 

Mode 

Conditions for Use 

Normal (MASM) 

QUIRKS 

Assembles und*r MASM 4.00 or MASM 5.00 

Assembles under MASM 4.00 or MASM 5.00; 
will not assemble under TASM without 

MASM51 or QUIRKS 

MASM51 

MASM51 and QUIRKS 

Requires MASM 5.1 for assembly . 

Requires MASM 5.1 for assembly but will not 
assemble under TASM with only the MASM51 


switch set 


C 


The following paragraphs detail the differences in operation offered by each 
of these modes. 


When used by itself, QUIRKS mode provides the following capabilities: 

□ far jumps can be generated as NEAR or SHORT if ASSUME directives for CS 
permit it. 

□ If present, one register can determine all instruction sizes in a binary 
operation. 

□ OFFSET, segment override, and other such information on = or numeric 
EQU assignments are destroyed. 

□ EQU assignments are forced to expressions with PTR or which will appear^ 

as text. ejj 

When used by itself, MASM51 mode provides the following capabilities: * 

□ Instr, Catstr, Substr, Sizestr, and \ line continuation can all be used. 

Q EQUs to keywords are made TEXT instead of ALIASes. 

□ Leading whitespace is not discarded on vtextmacro in macro arguments. 

When used together, MASM51 and QUIRKS modes provide the following 
capabilities: 

□ Each capability listed under QUIRKS is available. 

□ Each capability listed under MASM51 is available. , 

□ The PF, and PB local labels can be used. 

□ Procedure names are made PUDL1C automatically i n extended MODELS. 
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□ Near labels in PROCs can be redefined in other PROCs. 

Q The :: operator can define symbols accessible outside the current PROC. 

This versatility is one of the greatest advantages provided by Turbo Assembler. 
IDEAL mode’s extended syntax is an option none of its competitors offer. 

Like MASM, Turbo Assembler supports the 80386 and 80387 special instruc¬ 
tions and provides simplified segment-management directives that can greatly ease 
the chore ofsettingup the “right” interface conventions for your high-level language. 
If you use Turbo Pascal, Turbo Assembler’s special .MODEL tpascal directive 
automatically sets up the correct segment definitions for TP compatibility. No other 
assembler provides this advantageous option. 

Turbo Assembler also has some disadvantages, however. Because it is a single¬ 
pass assembler (version 2 can be configured to take as many as five passes), it can 
be confused by undeclared forward references that a multipass assembler would 
resolve automatically. Unlike MASM, Turbo Assembler cannot be configured by the 
DOS environment; however, Turbo Assembler can be configured by using its special 
TASM.CFG file (described in the on-line help files). 


The Files Involved 

No matter which assembler you choose, you will be dealing with at least two 
kinds of files, and probably more. The two that are always involved are the input file 
(the source code), which bears the file extension ASM by default, and the output file 
(the object code), identified by the default extension OBJ. 

Other files you may work with include MAC, INC, LST, CRF, and XRF files. The 
MAC and INC files can be included as pan of your input data if you use INCLUDE 
statements in the ASM file. You also can (and usually should) request that the 
assembler generate the LST listing file for you and that the CRF or XRF files generate 
* cross-reference of all the symbol names you use. 

Let’s look at these different kinds of files in more detail. 


The ASM Source File 

Every assembly language program originally exists as an ASM source file, 
because these files are what all the assemblers use as their primary input. In additiort 
to the normal ASM file, a program can also have MAC or INC files. But before looking 
at other files, let’s see what makes up the normal ASM file. The following file 
descriptions apply to each of the assemblers introduced earlier in this chapter. 
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Form;.: for an ASM file is relatively simple, the file must be a pure ASCII “text" 
file rather than a word processor document, which has embedded control characters 
that confuse the assembler. Each line of the file is considered a separate record, and 
each line normally is divided into four fields. 

These four fields contain the label, the operator, the operandfs), and any 
comments. Any or all of the fields may be blank; if all are blank, the record is ignored. 

The label field extends from the front of the line to the first blank space (a space 
character ora tab). If the line begins with a blank space, the label field is considered 
empty. If the label field is not empty but does not contain a directive, its content is 
entered into the symbol table by the assembler and eventually will be translated into 
an address. 

The operator field, which is the next field in the record, begins with the first 
nonblank character after the label field and extends to the next blank or to the end 
of the line, whichever comes first. It contains either an assembly language operator 
(also called an instruction), such as uov or RET, or a directive. 

As you may recall, directives are discussed in Chapter 2, “An Overview of 
Assembly Language." A direcr J ve, sometimes called a pseudooperator (or just a 
pseudo, for short), is an instruction to the assembler. It can appear in either the label 
or the operator field of a line (unless it requires a label; in that case it can appear only 
in the operator field). The assembler responds to a directive by performing some 
action, such as reserving memory in the case of the DB directive or noting the limits 
of a procedure in the case of PROC or ENDP. An operator, on the other hand, causes 
the generation of machine code that will perform a particular operation. 

Following the operator field is the operand field, which begins with the first 
nonblank character after the operator field and extends to the first semicolon (;) or 
the end of the line, whichever comes first. This field specifies what the operator or 
the directive is to operate on. For example, a uov operator has no purpose until you 
tell it what to move. The line uov ax , 1234 has no label, but contains the operator UOV 
and the operands ax , 1234. 

The final field is the comment field, which includes everything from the 
semicolon (if present) to the end of the line. Extended comments also can be created 
by using the COMMENT directive, which takes one character (any nonblank character) 
as its operand and then ignores all fields of all records until that character occurs 
again. The following example shows a comment at the end of a line of code: 

MAIN: UOV AX,C ; set AX to initial value 

where uain is the label, MOV is the operator, ax, 0 is the operand, and everything 
beginning with the semicolon is the comment field. 

The following snows an example of a multiline comment, using the comment 
directive: 
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COMMENT ? 


video'buffer area'll T ^ *"* ^ 
location „ . 1 "™'“° — "«-y 

dtis^^r*^^^ < ^ e ^^ r P'^*^tJ C by'ihc^asscinb^ e ' 'h' * 5i8 " 91 -ha. 

«'sign^(e) CVerJ ' I * 1 ' n8 * S a5sumccl lo ^>c a comment and ^norwlup'througluhe^nal 

With some assemblers, an asterisk , h ^ r 
*n.,re record as a commeni. Be«uX.7s Tl? Ch *J K '° f * «»rd marks the 
semicolon is safer than relying on this rnethoT *“ '**"• usi "6 - 

- x n~“x:;:: x? .t mac and inc *->« 

usually identifies a macro library which is I d | '? ClivC The extension 
repetitive tasks; the INC extension usu illv ,1 hod for s P eedln 8 up coding of 
such as one containing a collection aifrlJ C " 0tcs an >' OIhcr O’pe of INCLUDE file 
part Of the ASM file afass^X 1 ^ **-come 

ASM-fiie formatting ojJ es. * h 01 f f,lcs must foi *ow the standard 


The OBJ Output File 


«semXeXXma°mZrr;^XXama b h (i " f “>- - 

^ ink i" g P“S must be performed to “solX.ernaT'f ^ Bul becau “ 

executable. Chapter 4 , "Choosing and Us°n» You T v -T' 5 ' ,hest n '« are not 
greater detail. K sinfiYour Linker, discusses object files in 


The LST Listing File 


You decide whether a listinc f I 

extension 1ST This file is the asstmbl^ v^XX' 1 '^’ * h “ - «'e 

source statements as well as the machine h£" ° Ptr:,,ions ' and contains the 
ranslate A LST file may contain other informal B \ ,na,n,c " 0 ns into which they 
■n some cases, cross-reference data. '° n a S0, auc *' as a symbol table or. 

This file and listing can be a useful tool « k • 
you need to debug a program efficiently and " y " u can K^crutc the hard copy 
archiving. and ,h ‘ «'«»ng is great for hard-copy 
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1. The rund:\mcruaU> of Assemb ly UnguapT 


ii- . r.w. ornerated by MASM from a sample 

Microsoft (B) Macro Assembler version 6.00 Pa g e 1 - 1 

sums.asm 


Page 60,132 

Comment | 


File: 

SUMS.ASM for Microsoft Macro Assembler 6.« 

Author: 

Allen L. Wyatt 

Date: 

8/3/91 

Purpose: 

Given an in«e 8 er number *. find the sum of 

X . (X-t) . (X.2) * (X-3) * <*•«> ... ♦ 
Designed to be called from Microsoft C. 

Format: 

SUMS(X) 


>•••••• 


0000 

0000 

0003 

B8 0000 

sums 

PUBLIC sums 

.MODEL small, C 

.CODE 

PROC C value:SWORD 
MOV AX.O 

MOV cx, value 

0006 

8B 4E 04 


JCXZ S3 

0009 

E3 OB 

Si: 

ADC AX,CX 

OOOB 

13 Cl 

JC S2 

000D 

72 04 


LOOP SI 

000F 

E2 FA 


JMP S3 

0011 

EB 03 

S2: 

MOV AX.O 

0013 

B6 0000 

S3: 

RET 

0016 


sums 

ENDP 

0018 



END 


; initial!** to zero 
;Get actual value 
;Num-e, no need to do 
-Add row value 

;0uit if AX overflowed 

;Repeat prooess 
;Successful coaplet ion 
;Forca a zero 
•.Return to C 
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Microsoft 
sums.asm 


(R) Macro Assembler Version 6.00 


00/25/91 18:51:42 
Symbols 2 • 1 


Segments and Groups: 


Name 

dgroup . 

’*•••• • 

-DATA . . 

• • a 

Size 

GROUP 

Length 

Align 

Combine Class 

-TEXT . 

. 

• • • 

16 Bit 
16 Bit 

0000 

0018 

Word 

Word 

Public ’DATA 
Public 'COOE' 


Microsoft 
sums.asm 


( R ) Macro Assembler Version 6.00 


08/25/91 18:51’: 42 
Symbols 3 - 1 


Procedures, paramete-s and locals: 


sums . . 

Name 

Type 

Value 

Attr 

Value 

• • 

P Near 

0000 

TEXT 

Si ... 

• 

Word 

3P * 0004 


S2 . . . . 

• • m 

l Ue^r 

0006 

_TEXT 

S3 ... . 


L Nea. 

0013 

.TEXT 


* # • . 

L Near 

0016 

.TEXT 


_TEXT Lt-r *9th= 00 iq 


Microsoft (R) Macro Assembler Version 6 00 

sums.asm 08/25/91 18:51:4? 

Symbols 4 . t 


Symbols: 


•« a 4i e 


Type 


‘•vlui 


Attr 
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PCodeSize . 
COataSize . 
^Interface . 
PModel • • • 
Ocode . • • 
@data . • • 
• gfardata? 
gfardata . 

0St3CK • • 


Number 

OOOOh 

Number 

OOOOh 

Number 

0OO ih 

Number 

0002h 

Text 

_TEXT 

Text 

DGROUP 

Text 

FAR_BSS 

Text 

FAR_DATA 

Text 

OGROUP 


0 Warnings 
0 Errors 

The LST fie created by Turbo Assentb.er is simi.ar ro MASM s. The foUowtog 
is the listing file from Turbo Assembler. 


Turbo Assembler Version 3.0 
sums.asm 


08/25/91 13:54:28 


Pane 1 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

*••••••■ 

16 

17 

18 

19 0030 

20 0000 
21 

22 0000 


Page 60,132 
Comment 


File: 

Author: 

Oate: 

Purpose: 


SUMS.ASM for Turbo Assembler 3.0 

Allen L Wyatt 

8 / 17/91 


Given an integer number X, 

X ♦ (X• 1) ♦ <X 2 ) * (X 3) * 
Designed to be called from 


j the sum of 
■ 4 ) 


Format: SUMS(X) 


*•••••••• I 


PUBLIC sums 


,ums 


a 11. Pascal 

. ft f, rtf T LSI’»NS Sum: WORO 
MOr V:)! .»»' /.L»HU Hr.cn. j 


.MOCLl 
. CODE 
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1 

23 0060 

55 





1 

24 0001 

8B 

EC 


PUSH 

BP 

1 

25 0003 

88 

0000 


MOV 

BP.SP 

J 

26 0006 

88 

UJ 


MOV 

AX, 0 


27 000g 

E3 

0C 


MOV 

CX,Value 


28 0006 

13 

Cl 

SI: 

JCXZ S3 


29 0000 

72 

05 

ADC. 

AX, CX 






JC 

S2 


38 000F 

E2 

fa 





31 0011 

EB 

04 90 


LOOP 

SI 





JMP 

S3 


32 0014 

B8 

0000 

S2: 



1 

33 0017 

5D 


MOV 

AX, 0 

1 

34 0016 

C2 

0002 


POP 

BP 


35 001B 




RET 

00002h 


36 



sums 

ENDP 



37 



• 

END 



ito zero 
iGet actual value 
;Num= 0 , no need to do 
;Add row value 
;Qult if ax 
overflowed 
;Repeat process 
iSuccessful 
completion 
;Force a zero 


Turbo Assembler version 3 0 
Symbol Table 


08/25/91 18:54:26 


Page 2 


Symbol Name 


Type 

Value 

??DATE 

77FILENAME 

Text 

*08/25/91 * 

77TIME 

r “xt 

"sums • 

AVERSION 

Text 

*18:54:28' 

•32BIT 

Number 0300 

•CODE 

Text 

0 

•CODESIZE 

Text 

..TEXT 

•CPU 

Text 

0 

•CURSEG 

Text 

010IH 

•DATA 

Text 

_TEXT 

PDATASIZE 

Text 

DGROUP 

•filename 

Text 

0 

•interface 

Text 

SUMS 

•MODEL 

Text 

4H 

•STACK 

Text 

2 


Nxt 

CuMCUr 
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ewORDSIZE 

si 

52 

53 
SUU 
SI^IS 
VALUE 

Groups & Segments 


Text 

Near 

Hear 

Near 

Number 

Near 

Number 


_TEXT:C238 
_TEXT:001 4 
_TEXT:0017 
jUGROUP:BP♦00061 
_TEXT:0000 
(OGROUP'8P*00® 4 1 


Bit 


Size Align Combine Class 


„ Group 

DGRCUP 16 0O0 g Word Public DAT 

- 0ATA ^ 0010 Word Public COOE 

Notice that the listing file pr ”J ) “” d ^ mASM 6.0 does not. Asi Je 

the compiler (lines 23. 24. 53. and 34). but the one or ^ by , ht 

from this rather small roporo . I have presented these 

two assemblers are in the s>mbol taUe ann er P ress ,he information 

pages compf.te so that you ^n^vhen you assemble the file These com- 
bv using speci.il command-line P rhmters 5 and 6 ("Using Microsoft s 

respectively). ,.„r.| KS 

Not all printer's P , ,nt the same number of characters ptr lint direcl ivc 

were all formatted h r 60-line pages, with 1£2* “ r *jJ^^printer hand | cs only 80 
at the top of the ASM file controls this format. If >ou p 
characters per line, you easily can change the line to 


PAGE 60,80 

for a I .ST file form 
to you. 


aiicd f. r 80 characters per line. How you change the line 


More about Assembler Directives 

, ii r directives (introduced 

This Chapter has made frequent mention of »ssemb e ' (k . strlb ,ng what 
in Chapter 2. An Overview of Assembly l anguage , > though many 

they do A full list of directives appears earlier n '^^.“'ed often. The easiest 
- directives exist tor each assem icr. " n ) a ew ct | in (hi- sample programs 

wav li. learn those direrlives is to see a«v t ' complete tlescnption til the 

. lv ...„v|mis reference-manua.. lor.i compio 

a. i iv .-u* > V • c hapter 2>, •/\.s>emli»cr l>ircitne> 

assembler dircctnc-'* s c»- i , 
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sequeneeln <jTtl be>sc ' mvol'v^l ll . >a , f . CMn,r ° l Con<lilional a^mbly of code 

lions—areespeci illvimnori *"* "'i* , ' K< c,,nihon a,ul control of macro opera- 
function the same. ^ B "‘ h ~ 


Conditional Assembly 


to both MASM and TASM r "'’ T’ “ <,,U ' of lhc p<,wcrful features common 

decide b«Td omhe^. < ^ U,aumat «“«''*<> "H am that the ambler can 

blocks of code This , . >yn,b<,ls < or Hags), whether to include specific 

Clocks of code. This capabd.ty can greatly simplify ,he development process 

Th^., T ^| blC *■'* l,MS a fcw of 'he more common conditional assembly directives 
Table 3 4 Common conditional assembly directives. --* 


Directive 

Meaning 

IF 

Assemble if true 

2FB 

Assemble it blank 

IFDEF 

Assemble if defined 

IFDIF 

Assemble if different 

IFDIFI 

Assemble if different, ignoring case 

IFE 

Assemble if false 

IFIDN 

Assemble if identical 

IFIDNI 

Assemble if identical, ignoring case 

IFN8 

Assemble if not blank 

IFNOEF 

Assemble if not defined 

ELSE 

Used with any of the above 

ENDIF 

End of conditional block 


expression or argument*'^e directives listed in table 5.4 requires an 

based on that evaluation, takes appropriate aclton '* pression “S"™™ and . 
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ror instance, consider the following code segment: 


ifdef debug 


endif . _ . 

When this segment ts coupled with 

;n"^ 

Conditional assembly statements can be used in numerous ways. °“ d 
they can make the development process faster and less painful, just remember 
conditional assembly statements control only the assembler. 


includc oebug.asm 


Macro Operations 


If you’re familiar with C. the easiest way to understand what an asse ^ 
language macro operation does is to think of it as the equivalent of the Me » 
statement. Unfortunately, if your chosen language is BASIC or Pascal, that w 

you much! 

A macro operation, usually shortened to just 
bly language statements that has been assigned a symbolic statements 

been defined in an ASM fde, you can include the entire ""h™ 

simply by using the macro name as an operator. If you defi 
parameters, you can also pass operands to it at each call. 

In effect, the macro gives you the capability of 

be what you need most. Theoretically, you can re unreadabic to any 

your final program is nothing but a senes aching set of macro defini- 

skilled assembly language programmer with ^ JNC fik ^ ^ harxlly m 

tions, which are often hidden away in a separa 
printed out on the listing. 

. __Jirertives common to all the assemblers 

Table 3 5 lists the significant macro directi 

described in this chapter. 
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Table 3*5. Assembler macro directives. 

Directive 

Meaning 


MACRO 

Degin definition of macro 


IRP 

Repeat for each parameter 


IRPC 

Repeat for each character 


REPT 

Repeat sequence n times 


ENDM 

End sequence for all of above 


LOCAL 

Establish local-label list 


PURGE 

Remove listed definitions 



The first four directives listecl'Tti table 3.5 establish the start of a macro 
sequence; each sequence is ended by the enom directive, and sequences can be 
nested. Each sequence requires its own enom. Only the macro directive establishes a 
named sequence that can be called elsewhere; the three “repeat” directives provide 
an internal loop structure that can be used either in the main program or in a MACRO 
definition. 

The syntax used by all the assemblers for the macro ... ENOM definition se¬ 
quence is 

name MACRO list 


ENOM 

where name is the name by which the macro will be called subsequently, and list is 
an optional group of “formal parameters” that define what information can be 
passed into the macro when it is called. 

The LOCAL directive may be used inside a MACRO.. .ENOM sequence to specify a 
list of labels to be replaced with unique symbols each time the macro is expanded. 
This use of LOCAL in macros prevents problems caused when a macro defines the 
same symbol to mean two different addresses. 

The IRP, I RPC, and REPT directives follow a syntax similar to that used by MACRO 
but do not use a name field. Each also uses a different kind of parameter list. 

REPT uses a single expression that must evaluate to a numeric constant and 
repeats that many times the code contained in the REPT.. .ENOM sequence. 

IRP takes exactly one formal parameter, followed by an argument list enclosed 
in angle brackets. The assembler repeats the IRP.. .enom sequence once for each 
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directive instead of IRP. 

Iflpc is like IRP but instead of the angle-bracket-enclosed list of arguments. 
1RPC "quires a single text string. IRPC repeat the IRPC.. 

each character in that «nn^each ' 0 J C dlrec tive instead of IRPC. 

parameter. If you are using MASM o.u, you can use u»c 

The PURGE directive takes as its operand a list of macro names and 
each macro from memory. Normally, PURGE is not required; if, however you have 
dozens of lengthy definitions, each of which is used only once or rwice.you y 
need this directive to free memory for the assembler. PURGE does not genera J 
code, nor does it have any effect on your system; all it does is free some RAM for 

the assembler. 


To illustrate how macros can be helpful and how to define them, here’s an 
example. Let’s suppose that you want to use the BIOS functions to set the cursor type 
or to position the cursor. The following macros can be defined to do much of the 
detail work, and you have fewer lines of code to type: 


SETCUR MACRO 

MOV AH,1 ;; set cursor type from CX 

INT I0h 

ENOM 


MOVCUR MACRO R,C 

MOV OH,BYTE PTR R 
MOV DL.BYTE PTR C 

MOV AH,2 ;; set cursor to row R, col C 

INT 10h 

ENOM 


Once these two macros are defined, simply use SETCUR to set the cursor (you 
must make sure that CX contains the cursor type you want). 

MOVCUR, however, is a bit more complicated. This sequence illustrates the use 
of formal parameters in macro definitions. Because the parameter ist is , , 
time MOVCUR is called, the R in the MOV DH, BYTE PTR R line is rep ace nrnv iH(* 

argument you provided as part of the call, and the sccon argumen • 

similarly affects the C m the next line. Ifvou have stored the esire ro 

values in the low bytes of I6*bit variables named ROWWORD an - *y 

movcur with the following single line: 


MOVCUR ROW WORD,COL_WORD 
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Wi “ repl *' with the codc sequence 
M0V 0h .BYTE PTR ROWJVORO 
0L,8YTE PTR COL WORD 

IU a * 


MOV 


MOV 

INT 


AH,2 

ieh 


• set cursor to row R, col c 


can use 


' ' an > VPC or size ” ' hiS ” am P ,e 50 (h «you 

d^fi ^* Se ° pera,ors *f *e only location, g ' ng ln “ sem bler error. You can 
defined with the De or BYTE directives ““ When caJ,in * M0VCU " »« those 

ofthe to^Xnpacta^rAfcwtouns n ^ 8 C °" ec ‘ ions ofus 'h,l macros as a part 
"tore time eventually by^maltini^^ p^^^^' t j£jj™ cros wg l sav <t you much 

Summary 

This chapter covered concepts file* * n A 

«d o pmgams: hnMtoEl common to the use of the 

»nd QuIckAssembler, also by Microsoft. ft ' TUtb<) Assembl "' from Borland. 

Using the assembler properly is essential» 
language. The next chapter dlscu«l, l ° your success ln using assemblv 

a ^MsarsKBKassHi 
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CHAPTER 



Choosing and Using 

Your Linker 


T n Chapter 3, “Choosing and Using Your Assembler," you learned howto use the 
X assembler. You learned also that an assembler does not produce executable 
machine code. Instead, the OBJ file that the assembler creates must be linked 
successfully to work properly. 

The program you use to do this task is called, curiously enough, a linker. You 
need a copy of such a program to complete the examples in this chapter. Each of the 
assemblers discussed in Chapter 3 has a matching linker, but most of these Unkem 

work properly on OBJ files produced by any of the assemblers (or any other OBJ Ale 

that meets standard format specifications). 

You should note that some assemblers hide the actions taken by the linker For 

an executable file Is done automatically If you 

Q Programmer’s Workbench (comes with MASM 6.0) 

Q ML command-line program for MASM 6.0 

Q QuickAssembler 
Q Turbo Assembler 

This does not mean that linking Is not done, It simply means that linking is done 

«*n- time you iwemble a aouccc code-Ble: Newnhelea, you need <o undemand 
(he peocesa of Unking. 
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Unfortunately, OBJ files produced by some of the newer compilers 
follow the standard format specification; they go beyond it. Such J * e 
linked only by linkers designed to recognize the extensions. QuickC is 
language; its manual tells you to use only the linker furnished with it, although 
other versions of the Microsoft linker also work. 

This chapter covers how to choose and use a linker program. Most likely, you 11 
simply use the program that came with your assembler or high-level language, 
you may find that differences in performance iro n one linker to another 
significant enough to warrant a special purchase. 

Before comparing the linkers that come with each. t »he assembler*, let’s look 
at what a linker does. 


What the Linker Does 

A linker is a program that translates relocatable object code (produced by an 
assembler or compiler) into executable machine code. The linker performs the 
following three main tasks: 

□ Combines separate object modules into one executable file 

□ Attempts to resolve references to external variables 

□ Produces a listing (if you ask for one) showing how the object files were 
linked 

Most people refer to these programs as linkers (as I nave): others call them 
linkage editors. Whatever they are called, they do these three basic tasks. Many 
different linkers are available. 


Choosing Your Linker 

To help you decide whether to use the linker furnished with your assembler 
or high-level language or to purchase one elsewhere, here’s a quick overview of the 
similarities and differences of two major linkers: LINK from Microsoft and TUNK 
from Borland. 

Until recently, you had to use the Microsoft linker If you wanted to do source- 
level debugging (described In Chapter 7). This requirement no longer applies, 
however, because both linkers can now provide debugging information in their 
output EXE files. 
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LINK from Microsoft 

Microsoft and IBM. For nmv'iTil' IS Jvallabl ‘:’ lmm "“"VMiiirivs. mnsi nmii.u:ibly 

DOS) with any MS- or PC OOS coninm'' l ° P> <>f Kxl: " as even included (with 

pas, few versions of DOST U|7 FW TT ' " blt " lnd M*d f< ' r «■* 

language prtKluct. U ' “ a,wa >' s -ncIcclc-U with every Microsoft 

copy (the one with the hioh#> r ' ^ l ^ C m c s lo a * wa )' s use the most recent 

maintain downwardTom^hh 1 w' 0 " ? **““* Microswft h « attempted to 

rule is thatQuick^irequires'tharv’n 0 ” 1 ° n ^ re J ea f c to l ^ c ncxl - Theexccptionto this 
Chat version numt; With — ^ough 

withMASM (You only see the ve eversion number for the linker that came 

y the version numbers when you run the LINK program.) 

Like its companion assembler, and for the same reasons i in kv ,., k . ^ 

include an overlay manager that enables you to use the^^This reason d0CJ, . n0t 
can be used only when the high-level language provides such a manager (kitho^h 
third-party overlay managers are available as shareware thev k * j^“ thou * h 
of this book., The .eon otvrfir, „ u5ed for “^^ToSo"^,^ 
These portions are loaded into memory only when they are neeH**H a u 

“overlay" other unused portions of code. An overlay manager takes care of lo ^ 
these code blocks, as necessary. 8 carc oat ^ ,n g 

ThemajoradvantagesofUNKcanbesummedupeasily: its acceptably fast its 

accurate, and it s free when you buy any Microsoft language product. 

The disadvantages aren't as obvious. If you frequently link I,™ 

(such as EXE files greater than 200K). LINK seems to drag on forever S™ 8 ”" 15 
generating COM or BIN files rather than directly executable programs Snk mou •“* 
that you perform some additional steps. If your requirement* NK requircs 

of the option switches, other linkers (such as TUm^l f °" COnsistcnt use 
needs, but UNK cannot. And finally, UNK^et iome of C ° nflgUred IO ^ 
errors slip by without detection (opinion is divided amonv n° U f pr08ramm,n 8 
whether this is a bug or a feature). /* am ° ng P rof «*»onals as to 


TLINK from Borland 

Borland's TLINK program is furnished with all its high-level languages but is 
not available as a separate product. Unlike LINK, TUNK operates only from the 
command line anil lias no interactive mode. Although you may consider this a 
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*«■„»»* initially. wkh prac.ice you probably will atop using in.eractlvc mode 
anyway, and this difference eventually will lose its significance. 

Borland's own description of TL1NK is “lean and mean." Features of other 
linkers that Borland considered superfluous were dropped to create a fast, compa 
utility. Thus it has the shortest list of options as well as the smallest size. 


The major advantages of TLINK are its small size and speed. TLINK can also 
generate a COM. SYS, or BIN file directly without r luiring any subsequent 
conversion of its output. The major disadvantage ofT NK is that it cannot be 
purchased separately (it comes only with a Borland language). 

If you are using Borland’s high-level languages, TLINK is probably your linker 
of choice because it is tailored to work efficiently with other Borland products. For 
use with other languages, it does not offer enough unique advantages to warrant 

buying it. 


The Files Involved 

Throughout this chapter 1 refer to the file types the linker creates: the execu¬ 
table and listing files. 

Whether these files actually are created depends on how you invoke the 
assembler or answer the assembler’s prompts. Assuming that you assembled 
SUMS.ASM (from Chapter 3) using MASM, and that you requested all files, you 
should find the following files when you use DIR after assembly and linking. Also 
shown are the TEST files referred to in this chapter, but described fully in Chap¬ 
ter 5, “Using Microsoft’s Assembly Language Products." If you are working with 
Borland’s products, you will not be working with TEST.C. Rather, in Chapter 6 
(“Using Borland’s Assembly Language Products"), you will produce TEST.CPP for 
use with Borland C++. 

C>DIR. 

Volume in drive C is DCI 
Volume Serial Number is 16B2-BB87 
Directory of C:\TEST 


• • 

SUMS 

ASM 

<D1R> 10-16-91 

<DIR> 10-16-91 

1137 10-16-91 

10:38a 

10:38a 

10:37a 

SUV 3 

OBJ 

379 10-16-91 

10:37a 

SUMS 

LST 

3075 10-16-91 

10:37a 

TEST 

C 

672 06-20-91 

7:i0a 
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TEST 

OBJ 

1387 

10-16-91 

10:43a 

TEST 

COO 

4079 

10-1691 

10:43a 

TEST 

EXE 

9075 

10-16-91 

10:44a 

TEST 

MAP 

1915 

10-16-91 

10:44a 


10 file(s) 21719 bytes 

1626112 bytes free 


You may remember from Chapter 3 that SUMS.ASM is the assembly language 
source code file. SUMS.LST and SUMS.OBJ were created by MASM. TEST.C is the C 
source code (described in Chapter 5), or you may use TEST.CPP (described in 
Chapter 6). In either case, TEST.OBJ is the object code file generated by the C or 
C+ & compiler. The remaining files, TEST.MAP and TEST.EXE, were created by the 
linker. Sometimes the linker also creates a temporary file, VM.TMP. 

Don’t pay much attention to the file sizes. Had you used one of the other 
assemblers or linkers, the sizes might be slighdy different but the final results would 
be much the same. Before we take a look at the files created by the linker, let’s re¬ 
cap what the OBJ file does. 


The Input File (OBJ) 

The OBJ file is the output from the assembler or high-level language (except 
Turbo Pascal; when you create programs with Turbo Pascal, the OBJ stage is skipped 
and an EXE file is created directly). This example has two OBJ files: SUMS.OBJ, 
produced by assembling SUMS.ASM, and TEST.OBJ, created by compiling TEST.C 
or TEST.CPP. In actual practice you may have dozens of OBJ files, all to be combined 
into a single executable program. These OBJ files serve as the input files for your 
linker. 

Each OBJ file contains all the machine language code necessary to perform the 
corresponding portion of your program; the bytes where memory address informa¬ 
tion must appear are left blank, to be filled in by the linker when it determines what 
the address will be. This depends on where the OBJ module fits into the total 
program and can be determined only at link time. 

In addition to the machine language data, the OBJ file contains “housekeep¬ 
ing” information that lets it relate names (defined in one OBJ file) and references to 
these names (from other OBJ files) so that everything comes together. This 
information is used by the linker but does not become part of the final executable 
program; it can easily take more space in the OBJ file than the machine code itself. 
For this reason, the size of an OBJ file cannot be used as a reliable estimate of the size 
of the EXE file that is produced from the OBJ file. 
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The Executable File (EXE) 

The EXE file usually is the end result of the development process: an executable 
file. If the source files' logic and construction are correct, and no debugging or 
further development is needed, the EXE file is the finished program that you can 
invoke from DOS. 


The List File (MAP) 

The MAP file is the listing the linker produced as it processed each object code 
file. The MAP file contains at least the beginning and ending addresses of the 
segments the linker processed to create TEST.EXE, and may contain even more 
information. L1NK.EXE produces the following file, TEST.MAP: 


Start Stop Length Name 

Class 

00000H 01C5FH 01C60H _TEXT 

COOE 

01C60H 01C61H 00002H EMULATOR_TEXT 

CODE 

01C62H 01C62H O0000H C_ETEXT 

ENDCODE 

01C70H 01C70H 00000H EMULATOR_DATA 

FAR_DATA 

O1C70H 01CB1H 00042H NULL 

BEGDATA 

C1C82H 02071H OO3C0H _DATA 

OATA 

32072H 02073H 00002H XIQC 

DATA 

02074H 02081H 0000EH OBOATA 

DATA 

02082H 0208FH 0000EH COATA 

OATA 

02090H 02090H 00000H XIFB 

DATA 

02090H 02090H 00000H XIF 

OATA 

02090H 02090H 00000H XIFE 

OATA 

02090H 02O90H 00000H XIB 

DATA 

02090H 02090H 00000H XI 

DATA 

02090H 02090H 0000OH XIE 

DATA 

02090H 02090H 00000H XPB 

OATA 

02090H 02091H 00002H XP 

data 

02092H 02092H 00000H XPE 

DATA 

02092H 02092H O0O00H XCB 

DATA 

02092H 02092H 00000H XC 

data 

02092H 02092H 00000H XCE 

data 

02092H 02092H 00000H XCFB 

data 

02092H 02092H 00000H XCF 

data 

02Q92H 02092H 000O0H XCFE 

data 

02092H 02092H 00000H CONST 

CONST 

02092H 02099H 00O08H HDR 

MSG 
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0209AH 0216FH 000D6H MSQ 
02170H 02171H 00002H PAD - \ 
02172H 02172H 00001H EPAO 
02174H 02174H 00000H _BSS 
02174H 02174H 00000H XOB 
•2174H 02174H O0000H XO 
•?174H 02174H 00000H XOE 
021BOH 0237FH O0200H c.common 
02380H 02B7FH 00800H STACK 

Origin Group 

«1C7:0 OGROUP 

Program antry point at 0000:O0DC 


USG 

MSG 

MSQ 

BSS 

BSS 

BSS 

BSS 

BSS 

STACK 


TUN&‘ l 7 aed T ES „T CPPwlth the BorUnd C++ compUerand then used 
to link the sample flies, the following map (lie, TEST.MAP, Is created: 

8tart Stop Langtft Name Class 


00000H 027E4H C27E5H .TEXT 
027F0H O27F0H 00000H _FARDATA 
027F0H 027f;0H 000O0H _FARBSS 
027F0H 027F0H 00000H _OVERLAY_ 
•27F0H 027F0H 00000H _1STUB_ ~ 
•27F0H 02O3BH 0054CH .DATA 
02D3CH 02O3CH 0000OH _CVTSEG 
02O3CH 02O3CH 00000H _SCNSEQ 
02D3CH 02D3CH 00000H _CONST 
0203CH 02O4OH 00012H .INIT. 
02O4EH 02D4EH 00000H .INITEND. 
02O4EH 02D59H 0000CH _EXIT_ 
02O5AH 02D5AH 00000H .EXITEND. 
02O5AH 02OA1H 00048H _BSS 
•20A2H 02DA2H 00000H _BSSENO 
02O80H 02E2FH 00080H .STACK 

Program entry point at 0900:0000 


CODE 

FAR.DATA 

FAR.BSS 

OVRINFO 

STUBSEG 

DATA 

DATA 

DATA 

CONST 

INITDATA 

INITDATA 

EXITOATA 

fXITDATA 

BSS 

BSSEND 

STACK 


to each exampfe you will notice that the compiler automatically included a 
number of segments beyond those you explicitly requested Asvourn™™ d d 

you will find this map file Increasingly more valuable in your drtuLS^foST' - 
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The Temporary File (VM.TMP) 

Notice that nothing in your disk directory looks like a temporary (TMP) . 
The linker creates this type of file only if necessary. 

The linker normally attempts to perform all operations in ^ 

possible (because the program Is large or because 

processed), the linker creates a temporary Me on the DOS ^«>>«^eandMMOtt 

intermediate work file to store the linked portions o ^^.P^^^ons 
DOS versions, this file was always named VM.TMP; with DOS 31 »nd Uter visions; 

which provide facilities for automatic creation of fi ^!^lf^tlme 

name will be a strange blend of numbers and letters derived from the date and time. 

If LINK needs to create a virtual memory file * 2 message similar to the follow 
ing is displayed, where drive B Is the default drive: 

VM.TMP has been created 

Do not change diskette in drive B: 

If you are using floppy disks or working in a networked environment, deleting 
no rhe VM TMP file while LINK is working can have unpredictable results. 

^UNKtfi^cd. u^omauc^y de.etcs the tempos Ele. 

*c temporary file the same way, although the exact messages may differ slightly. 

P „ most practical development purposes, you will never see LINK create thU 
mott operations can be done in memory. I have used LINK routinely 
te mporary • of 54K^nd libraries of 30K to create a ) IK EXE file, and all operations 

TeretlS performed in memory (using an older system with 640K of RAM). 

Using Linker Options 

aii 1 kers have several parameters that alter how the linkers function. These 
, L are known as options or switches. You can enter them directly from the 
parame running the linker interactively. Table 4.1 lists 

"fer^ ,r£r options and thclr meaning,. 


Table 4.1. Linker options. 
Option 


LINK TUNK Meaning 


/? 

n> 

/K-.slze 


X 

X 

X 


Display help information. 

Enable 32*blt processing. 

Align segment data along boundaries 
of size bytes, where size is a power of 2. 
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Option 

U/VA 

TUNK 

Meaning 

/BA 

X 


Operate in batch mode; do not prompt 
for LIBs. 

/c 


X 

Make lowercase significant in exports 
and Imports. 

/c 


X 

Make lowercase significant in symbols 
(same as /NOI in LINK). 

/CO 

X 


Create CodeView-compatlble file. 

/CP \para 

X 


Set maximum allocation space. 

/d 


X 

Warn if libraries have duplicate symbols. 

/DO 

T 


Use MS-DOS segment ordering. 

/DS 

X 


Place DGROUP (a program’s data 
group) data at high end of group. 

/E 

X 


Pack the EXE file created by LINK. 

/e 


X 

Ignore extended dictionary (same as 
/NOE in LINK). 

/F 

X 


Convert far calls to NEAR where 
possible. 

/h 


X 

Display TLINK help information. 

/HE 

X 


Extended LINK help information. 

/HI 

X 


Load program in high memory. 

A 


X 

Initialize all segments. 

/INC 

X 


Prepare for incremental linking. 

/INF 

X 


Display what link process is doing. 

/l 


X 

Include line numbers in map file (same 
as /LI in LINK). 

/L path 


X 

Specify library search path. 

01 

X 


Indude line numbers In map file (same 
as/I In TUNK). 

/m 

X 

X 

Include global symbol table in map file. 

/n 


X 

Exclude default libraries (similar to 
/NOD In LINK) 

/NOD:msm# 

X 


Exclude default libraries (similar to /n in 


TUNK). If you specify name, only the 
specified default library is ex: luded. 


conlinut 
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Table 4.1. 

nntinued 



Option 

LWK 

TUNK 

Meaning 


/NOE 

X 

Ignore extended dictionary (same as It 
in TUNK) 

/NOP 

X 

Do not translate FAR calls. 

/NOG 

X 

Do not associate groups. 

/NOI 

X 

Do not Ignore case differences (same as 
/c In TUNK). 

/NOL 

X 

Do not display copyright information. 

/NON 

X 

Same as /DO, but excludes additional 
bytes at start of _TEXT segment. 

/NOP 

X 

Do not pack code segments. 

/o 

X 

Create overlays. 

/O Ant 

X 

Set overlay loader Interrupt number. 

IP^size 

X 

Pack code segments up to the optional 
segment size (same as /PACKC in 
MASM). 

/PACKC -.size 

X 

Pack code segments up to the optional 
segment size (same as /P in TUNK). 

/PACKD.size 

X * 

Pack data segments up to the optional 
segment size. 


IPADCjize 

X 


Add filler bytes to the end of code 
segments for later incremental Unking. 

fPADDMze 

X 


Add filler bytes to the end of data 

segments for later incremental Unking. 

l?AV 

X 


Pause for disk change. 

SPM:type 

X 


Used to specify the type of OS/2 or 
Windows application being Unked. 

/Q 

X 


Produce Quick Library QLB file. 

/s 


X 

Generate detailed segment map. 

ISExeg 

X 


Specify maximum program segments. 

ISTisize 

X 


Override suck sue. 

A 

X 

X 

Create COM/SYS/BIN image file 

/Td? 


X 

can be c—COM or e=EXE) 

/Tw? 


X 

^rr ,abk Winflows (third 

letter can be e=EXF. or rf=DLI.)' 
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/V 

m 

/X 

'yc 

/yx 


X 

X 


iT,-r™ PU< 2!! ryp ' <‘ h,rd ,e “« «n 

be c-COM, <?=EXE, or d= DLL). 

include debugger data in EXE file (same 
a«/CO in LINK) 1 

issue warnings when using displacement 
nxup values. 

Do not produce any MAP file. 

Expanded memory swapping. 

Extended memory swapping. 

»**> that some ofibe opton^ Stup^rc* avail “ ble in > our «nker version. Note 
to remember is that TUNK is semiUvcT‘ n lowerase : *« Point 

YOU can include .inker onrin ?UOm ' WNK “ 

the interactive forma, C ° m "™ d " 

r ^ Ub1r * 


Let’s look at each of the listed 


options. 


Display Help Information (/? or /h) 

■» a quick tray^Tget help fof y ° ur “"her, this 

displayed on the screen: U USC |S ° ption ^ UN K the following is 

C:\IMSM60>LINK /? 

Microsoft (R) Segeentad-Executable Linker v*..* 

Copyright (C) Microsoft Corp IPM-ippi w , ’ 5 ,3 

• M1 rights rosorvod. 

Usage: 

LINK 

LINK 0<response file* 

UNK *ob],».«««file>,<eapfii.>,, Ubs>i<d „ fu<> 
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*>lid options are: 

/? 

/BATCH 

/CPARMAXALLOC 

/OSALLCCATE 

/ F ARCA^LTRAN&ATION 

/HIGH n 
/INFORMATION 
/MAP 

/NOEXTDICTIONARY 

/NOGRCUPASSOCIATION 

/ NOLOGO 

/NOPACKCOOE 

/RACKCODE 

/PADCODt 

/PAUSE 

/QUICKLIBRARY 

/STACK 


/alignment 

/CODEVIEW 
/OOSSEG 
/EXEPACK 
/HELP 

/INCREMENTAL 

/LINENUMBERS 

/NODEFAULTLIBRARYSEARCH 
/NOFARCALLTRANSLATION 

/NOIGNORECASE 

I nonullsoosseg 

/OVERLAYINTERRUPT 

/PACKDATA 

/PADDATA 

/PMTYP^ 

/SEGMENTS 
• /WNY 


/WARNFIXUP 

Notice that the long forms of the option names are listed. You need to enter 
only enough characters to differentiate the option you want from the others. 

When you use this option with TUNK, the following screen is displayed: 


C:\TASM30>TLINK /? 

Tu-bo Link version 5.9 Copyrloht (c) 1991 Borlond International 
syntax: TL1HK obiUl.., ex.fil.. -»«U. iMOm. 

9 XXXX indicates us. response file xxxx. 


In Map file with public* I* ™ 

1 1 initialize all segment* /l 

/L Specify library search path* /s D< 

/n no default libraries I* * 

/c Case significant in symbols /3 * 

/o Overlay switch I* * 

/Pl=NNNNN] Pack code segments I a-nn 

/ye Expanded memory swapping /yx E 

/e Ignore Extended Dictionary 
/t Create COM file (same as /Tdc) 

1C Ouse sensitive exports and imports 
/Txx Specify output file type 


/x No map file at all 

II include source line numbers 

/$ Detailed map of segments 

/d Warn if duplicate symbols in libraries 

1 3 Enable 32 bit processing 

/v Full symbolic debug information 

/A=NNNN Set NewEve segment alignment 

/yx Extended memory swapping 
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/Tdx DOS image (default) 

/Twx Windows image 

(third letter can be c=COM, e=EXE, d=DLL) 


Enable 32-Bit Processing (/3) 

proc ™ 5 r 1 Y NK '° ha " dle P r °P"'y 32-bit code for the 80386 

Sl j S* OPUm , ° n ' y When yOU have code that 

«P y uses 32-bit addressing, as it slows down the work TLINK does. 

Align Segment Data (/A -.size) 

This option is used primarily to reduce the size of the physical gaps between 
sera in a disk file. Bod, LINK and TLINK use a default segmem boundary 

bytes. If a segment takes less space than 512 bytes or some multiple of 512 tmes the 
linker pads out to the next 512-byte boundary. 

With this option you can specify a smaller segment boundary, provided that the 
boundary size (,n bytes) is a power of two (2,4,8,16.32, etc.). If your program has 
nuny segments, this option may make your linked file much smaller. It does not 
affect the memory your program occupies while executing. 

Operate Linker in Batch Mode (/BA) 

... 11,15 °£ t,0n ^ USCS LIN * to not Prompt for a library or path name if a required 

library or object file cannot be located, and may result in unresolved externals in 

your files. It is included to facilitate use of the linker with batch files and make 
programs. " “ 


Do Not Ignore Case Differences 
in Exports and Imports (/C) 

| C °P ,ion ™ N K >° differentiate between upper- and lowercase 

and im P° r,s sec *' on of module. Using /C or /o turns on 
oac sensitivity, whereas /C- turns off case sensitivity (the default). 
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Do Not ignore Case Differences 
(/c or /NOI) 

The /c option causes TL1NK to differentiate between upper- and lowercase 
letters. The /NOI option does the same thing with LINK. 


Create Debugger-compatible File 
(/CO or /V) 

This special option, available to LINK as /CO and to TLINK as /v, instructs the 
linker to create an EXE file that is compatible with high-level debuggers such as 
CodeView and Turbo Debugger. For more information on using these products, 
see Chapter 7, “Debugging Assembly Language Subroutines." 


Set Allocation Space (/CP-.para) 

With this option, you can specify to LINK how much memory (in paragraphs) 
the program is to use. MS-DOS requires that programs request a block of memory 
for program use so that there are no memory conflicts. Usually, the linker requests 
all memory, 65,535 paragraphs. Because this much memory is never available, MS- 
DOS returns the largest contiguous block of memory for program use. 

Using this option lets you state explicitly how much memory should be 
requested, para is the number of paragraphs (16-byte memory blocks) your program’s 
code and data need Because the amount of memory you designate probably will be 
smaller than the amount the linker normally allocates, memory will be freed for 
other purposes. 

If para is smaller than the amount of memory the program needs, the linker 
ignores the para parameter and requests the maximum memory area. 


Warn about Duplicate LIB Symbols (/d) 

This option forces TUNIC to list all duplicate symbols encountered in the 
library li' cs 11 searches, le i is used when you have identical symbols in different UB 
lil« ft* different code and want to know which file TLINK encounters Best because 
the code in that file will be the code TLINK uses. 
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Use MS-DOS Segment Ordering (/DO) 

rulcs^^r^'Lllows' 0 PrOC " S fik ' S U5 ' ne ' ht ' MSD0S -^„, order,„ B 

1 W,th * Cb5S ” lm ' ° f C0DE are P laccd at Ihe san °f Die linked 

2 All segments outside the DGROUP are placed next. 

3. DGROUP segments are in the following order: 

•4 

Any segment with the class name BEGDATA 
Any segment not of class BEGDATA, BSS, or STACK 
BSS segments 
STACK segments 

Normally, the linker copies segments to the file in the order they occur in 
the object files. 


Place DGROUP at High End (/DS) 

The linker normally assigns data in DGROUP (a program’s data group) to a 
low address, starting at an offset of 0. This option causes the linker to start data 
assignments so that the last byte in DGROUP is at an offset of FFFFh, or the top of 
memory. Usually, this option is used with the /hi option. 


Pack EXE File (/E) 

The /E option causes LINK to create an EXE file that is optimized for size. Use 
of this option may result in a more compact EXE file. How much, if any, space this 
option will save through packing the executable file depends on how many repeated 
bytes arc used in the file. If your program requires much relocation upon loading, 
this option causes the relocation table to be optimized for size. If the resulting EXE 
file is smaller, it logically will load faster than a file linked without this option. 

If you plan to convert your EXE file to a COM file, do not use this option. If you 
pack your EXE file, you cannot convert it to a COM file. 


Scanned by CamScanner 



Ignore Extended Dictionary (/e or /NOE) 


memory you can gel to link your program. 


Translate FAR Calls where Possible (/F) 

This option causes CALL instructions to FAR procedures to be converted into 
a PUSH CS followed by a NEAR call instruction, which takes fewer bytes in the program 
and executes more rapidly. 


List Linker Options (/HE) 

The /HE option causes LINK to load the QuickHelp utility program and display 
extended help information in an interactive format. 

To view the available options for TLINK, simply omit all command-line 
parameters, as follows: * 

TLINK 

Load Program in High Memory (/HI) 

Normally, the linker assumes that a program is to be loaded at the lowest free 
memory address. The /HI option instructs LINK to load the linked program as high 
in memory as possible. This option typically is used with the /OS option. 

i m • 

Initialize All Segments (A) 

This option causes TLINK to output all segments named in the OBJ files, even 
if some of them do not contain any bytes. Without this option.-TLINK will not output 
empty segments (inserted by some high-level languages to establish segment 
sequence). LINK, which always outputs all segments, does not need this option. 


All newer versions of the library-manager utilities (discussed In Chapter 9, 
“Developing Libraries”) can create extended dictionaries that the linker no ™JJy 
will use to complete the linking process more rapidly. This option, known to TU 

as /• and to LINK as /NOE, prevents the linker from using any extended dictionary that 

may be available. Ordinarily, this would be done only if you need every byte of 
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Prepare for Incremental Linking (/INC) 

If you plan to do incremental linking to speed the development process, use 
this option. Incremental linking is done with both LINK and a program called IUNK. 
This option causes the linker to produce a SYM and an ILK file, each of which 
contains Information needed by IUNK. 


Display Progress of Linking Process (/INF) 

This option causes LINK to display a running account of what it Is doing. The 
display is used primarily to debug problems that show up as an inability to link your 
OBJ files successfully. 


Include Line Numbers in List File (/I or /LI) 

If you specified a listing file, you can use the /I (TASM) or /LI (MASM) option 
to include a list of all source-code-line memory addresses in the list file. Such a list 
is helpful when you are debugging. 

This option is useful only if the OBJ file includes a line number, which depends 
on how the OBJ file was created. MASM does not include line numbers in the OBJ 
file, but many high-level languages do. If the OBJ file does not Include line-number 
information, no ex tr a information is generated in the MAP file. 


Specify Library Search Path ( [/Ipath ) 

This option is used to tell TLINK where (in addition to the current directory) 
l ibrary files can be found. You can specify multiple paths if you separate them with 
semicolons. 


Include Global Symbol Table 
in List File (/m) 

When you include the /« option, the linker creates a public symbol listing. This 
option forces a listing file to be created. The listing file has the name of the first OPJ 
file and the extension MAP, unless you provide a different name on the command 
line or at the interactive prompt. 

Note that if you are using LINK, this option does not have to be lowercase. 
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Do Not Use Default Libraries 
(/n or /NOD:tia?ne) 

Some high-level languages include in the OBJ file the names 
for the linker to search when linking the file. This option, known to TUNIC as/nand 
to LINK as / nod, overrides such specifications so that the linker ignores any » 
the language specified in the OBJ files. 

MASM gives you the option of including the name of a specific library to be 
ignored. All default libraries except the one named will be used. 


Do Not Translate FAR Calls (/NOF) 

This option prevents LINK from converting FAR calls into NEAR calls. Unless this 
option is used, LINK'S default condition is to insert a PUSH CS machine instruction, 
then emit a near call using only the CS offset. This saves both time and space but 
confuses debugging efforts. 


Do Not Associate Groups (/NOG) 

The /NOG option instructs LINK to ignore GROUP associations when it assigns 
memory addresses for data and program code. The option te intended specifically 
for use with object code generated by old versions of the Microsoft FORTRAN and 
Pascal compilers. 


Suppress Copyright Message (/NOL) 

This option causes LINK to suppress the copyright information normally 
displayed. If included, this option must be the first one on the command line. 


Use MS-DOS Segment Ordering 
without Nulls (/NON) 

This option instructs LINK to process files in the same manner as the /DO 
opium, but iu> null characters arc placed at the beginning of the JTEXT segment, If 

it is defined. 


Scanned by CamScanner 



Chapter -4: Choosing and Using Your Linker 


Do Not Pack Code Segments (/NOP) 

This option prevents LINK from packing contiguous code segments that h* c 
different names into a single segment for loading. Because this is the default con¬ 
dition, /NOP usually is not needed. If LINK is switched by an environment variable to 
e /PAC condition, however, /NOP at the command line restores nonpacking mode. 


Create Overlays (/o) 

The / o option is used to turn on overlay handling, and / o • is used to turn it ofT. 
All files between this option and the next comma or the /o- option are treated as 
overlays. 

If you specify /o Pint, where int is an interrupt number, TLINK will use int as 
the overlay-loader interrupt number (similar to LINK'S 10 option). 


Set Overlay-Loader Interrupt Number 
( JOdnt ) 

The /0:inr option enables you to specify the interrupt number used by an 
overlay loader. Use this option with object code generated by compilers that sup¬ 
port overlays, int is the number (between 0 and 255) of the MS-DOS interrupt to 
use for the overlay loader. Normally, interrupt 63 is used, but it may already be 
reserved for some other use on your system. 


Pack Contiguous Code Segments 
(J?=size or /PACKOsire) 

This option instructs the linker to pack adjacent code segments bearing 
different names into a single segment and adjust offset addresses accordingly. The 

resulting code segment cannot be larger than size ; if it is, a new code segment is 
begun. 

Used with the /F option, this option can significantly reduce code size and 
increase operating speed for programs that have multiple code segments. 
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Pack Contiguous Code Segments 
(/PACKD:rize) 

This option Instructs LINK to pack adjacent data segments bearing different 
names Into a single segment and adjust offset addresses accordingly. The f suiting 
data segment cannot be larger than size; if it is, a new data segment is begun. 

This option is valid for Windows and OS/2 programs only. 


Pad Code Segments (/PADC:ri2e) 

In preparation for later incremental linking, this option causes LINK to add a 
specific number of filler bytes to the end of each code segment. The default to 0 added 
bytes, but you can specify a particular size. 

This option must be used with the /INC option. 


Pad Data Segments (/Y>ADD.size) 

In preparation for later incremental linking, this option causes LINK to add a 
specific number of filler bytes to the end of each data segment. The default to 16 
added bytes, but you can specify a particular size. 

This option must be used with the /INC option. 


Pause for Disk Change (/PAU) 

Using this option causes LINK to display a message and wait for you to switch 
disks before the linker writes th.t EXE file. This option to particularly useful if you 
have a limited number of disk drives or disk space. When the linker has written the 
EXE file completely, the linker prompts you to mum the original disk. 


Specify Application Type (/PM .type) 

This is the option to use when linking programs for Windows or OS/2. It allows 
you to specify the type of application program being linked, where type is a specific 
value from table 4.2. 
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Value 



Produce QuickLibrary QLB File (/Q) 
normllCT^abljS^ ,° U ' PU ' * QLB " ,e ra,her ,han a 

languages. ™ QLB f sulub,c for use with the Microsoft Quick 

Generate Detailed Segment Map (/s) 

llsting T fi(e. OP,IOn direC,S TUNK '° Benera " “ de,ailcd ■*«« «P « pan of .he 

Specify Maximum Segments (/SE:seg) 

~ ISLVSi Z TZXttEZ 

between*! . andLM24. han< * ,eson *>' U P IO *28segments *e/can be any mirntwr 

Override Stack Size (/ST:size) 
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Produce Binary Image File (/t) 

Directs the linker to produce a binary image file (COM or SYS style) rather than 
an EXE file. This is the same as using the /Tdc option. 


Specify Executable File Type (/Td? or /Tto?) 

. These options allow you to specify how you wan. TUNK to create the urge, 
executable file. The following are valid choices: 


Option 

/Td 
/Tdc 
/Tde 
/Tw 
/Twd 
/Twe 


Meaning 
Create a DQ$ EXE file (the default) 
Create a DOS COM file 
Create a DOS EXE file (the default) 
Create a Windows EXE file 
Create a Windows DLL file 
Create a Windows EXE file 


Issue Fixup Warnings (/W) 

Normally when LINK is creating a segmented executable file, it does not issue 
warning every time such a fixup occurs. 


Do Not Generate Any Listing File (/x) 

««.inn available only to TLINK. directs the linker not to generate a listing 
indlke rtte other linkers, TLINK generates a MAP file by default and must be 
directed no. to do so if you do no, want one. 
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Use Memory Swapping (/ye and /yx) 

Un- «“—r »^P™ 

to use che /yx or /yx* optlonto enahl ^ ^ CXpanded mcmor Y. you may want 

to turn off swapping ,o expanded mem^v'" 8 '° c3 “ cnded mcmor * or “** ■ 
swanninn m n JL.Jf j cxpanded memory. You can also use /ye or /ye* to enable 

default condition. C lnCm0^y, although would be redundant because it is the 


Summary 

because durin’cniviinl ** Vilal “ e ° mple,k>n of a "y program. Using a linker is easy 
^pTcadng ^on^ ''" d " WOtIy ^ usi "«°P*ion» or other 

. *" lh ** cha P tc ^ V° u havc compared the characteristics of the two majorlinkcrs 
In next few chapters you leam how to use each linker with its associated 
assembler to create a finished program. 
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Using Microsoft’s 
Assembly Language 

Products 


Y assemblersand^linkerv'lnchis^haDt^ 0 di ? Crcncc$ bctwecn the two major 
the assembler and linker from Microsoft- Chapter 6fo^ C UNK ’ 

language products. This chapter and Chapter 6 B ° r,and s asscmb, y 

content; they differ only in the soeciflr h«»*i ^ In construction and 

provided by Microsoft and Borland. at app y to tbe environments 

MASM, a contraction for Macro Assembler h,« u— 
current version, MASM 6.0, has been out since the se^d % ,0n8 time Thc 

more capabilities and features than previous versions as weU«m° f ‘T " oefcrs 
affect how you program and use the assembler itself.’ U y chan 8« ,ha ‘ 

LINK has been around as lone as MASM in rk* . , 

DCs. UNK. EXE was distributed free with every copy of Do s a ]?, 0f MS ' D< ? S Ind PC 
d*k), Although UNk no longer comes with DOS, itTs shin«d^ J U,il,i ” 
language product. The version shipped with MASM 6.0 to UNI^ 1 ^ CfOS ° ft 
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A Sample Program 


To proceed through this chapter. you need a sample sub°utmc to • **£>*£ 
This subroutine will be neither large nor complex, nor will it 
reasons for using assembly language. Although writing this routine " C wouldbe 
easier than writfng it in assembly language, I will use It to demonstrate how 
assemble (and later link and debug) a subroutine. 

Let s assume that you need to determine the total number of Mocks In a 
pyramid where each ascending row contains one less block than the row benea 
and the top row is only one block (see fig. 5.1). 




■ SB 

CEUB 


CeQEB 

BDCBBQ 

EEZBBBB 

saBDEBaa 

BBCBBBSBQ 

BBBBEGQBBa 

bbbbqdbbebb 

BBBBQBSBBBBB 

BBBBC39BBBBBB 

bbbbbbbbbbbbbb 

bbbbbbbbbbqbbbb 


The bottom row contains 15 blocks, the next row contains 14, and so on, with 
only one block In the top row. Your job is to calculate the total number of blocks 
needed, given only the number of blocks in the bottom row. You’ll use the sample 

program to do the job. 

The program (SUMS.ASM) is designed to be called from C. When passed a 
signed l6-bit Integer, the program calculates and returns the result as a signed 
integer. The assembly language subroutine, written for MASM 6.0, b as follows: 
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Pace 63,132 
Comment ! 




File: 

SUMS.ASM 

Author: 

Allen L. Wyatt 

Date: 

8/3/91 

Purpose: 

Given an integer n 
x * (X-1) ♦ (X-2) 
Oesigned to be cal 

Format: 

S'JMS(X) 

• 

PUBLIC sums 

.MODEL small, C 

■ CODE 

sums 

PROC C Value:SWORD 
MOV AX,0 

MOV CX,Value 

JCXZ S3 

CLC 

Si: 

ADC AX.CX 

JC S2 

LOOP SI 

JUP S3 

S2: 

MOV AX,0 

S3: 

RET 

sums 

ENDP 

END 


(X-3) ♦ (X-4) 


♦ 2 + 1 


;Initialize to zero 
;Get actual value 
;Num*0, no need to do 
;Initialize for start 
;Add row value 
;Quit if AX overflowed 
;Repeat process 
;Successful completion 
;Force a zero 
; Return' to C 


If the entered number results in a sum greater than 65 535 fthr i 
un^gned in.eger number that can be held in 16 bio), the subroutine sers rheS 

You °°’* ,ead *? d ,his P ro 8 ram - W>en you are done, save it as SUMS^SM 

You are now ready to assemble the program. 
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Using MASM 6.0 

Before beginning the assembly process, make sure that you ha\e installed 
MASM 6.0 according to the instructions that came with the software. If you install the 
full language system, you can assemble in one of three ways. T he first wa> is to use 
the Programmer's Workbench shell. This is perhaps the easiest way, especially il you 
already are familiar with other Microsoft products, such as QuickC and 
QuickAssemblcr. 

The other two ways to assemble the program are closely related. In earlier 
versions of MASM, the program that did the assembly was called MASM.EXE; in the 
latest version, it is called ML.EXE. Actually, ML.EXE does more than just assemble a 
program. After assembly is completed. ML.EXE also calls the linker (LINK.EXE), and 
totally bypasses creating an OBJ file. 

Although MASM.EXE is still available with version 6.0, all it docs is translate the 
older MASM command-line switches to the ones appropriate for MLEXE. Then 
control is passed to ML.EXE for assembly. Whether you use ML.EXE or MASM EXE, 
you do the assembly from the DOS command line. 

Many things determine whether you use the Programmer’s Workbench inter¬ 
face or work strictly from the DOS command line. Perhaps the biggest deciding factor 
is habit. If you have been using MASM for a while, or aire used to working with other 
languages from the command line, you probably will want to do the same with MASM 
6.0. After all, you probably are familiar with your favorite editor, and have a series 
of batch files prepared to help in the development process. 

if you are new to assembly language, however, or have used the Programmer s 
Workbench shell with other Microsoft languages, you probably will feel comfortable 
doing the same here. 

This chapter provides instructions for assembling a file using both the 
Programmer's Workbench and command-line methods. You choose the one you 
most comfortable with. 

Using MASM 6.0 in Programmer’s 

Workbench 

If vou have MASM 6.0 fully installed, make sure that SUMS.ASM (the subroutine 
01 c) i5 in your current disk directory. A. the DOS prompt, type 

niuQ 

rno 

to load and enter the Programmer s Workbench. A few messages will flash quickly 
on the screen, indicating that PWB is opening files it needs. When the Programmer’s 
' Workbench is fully loaded, your screen will look similar to figure 5.2. 
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Fi H * 2 Programmer s Workbench serve,,. 



Very possibly, if you have used the Programmer s Workbench before, the file 
you previously were working on may be loaded already (instead of a blank 
workspace). If this is the case, close the file so that you are beginning fresh. 

Notice the series of pull-down menus across the top of the screen. These 
menus are used to issue commands within the Programmer's Workbench. You may 
want to take a moment to familiarize yourself with each of the menus. If you are using 
the keyboard, you can access a menu or command by pressing the Alt key and then 
pressing the highlighted letter. For instance, to access the File menu, you would 
press Alt-F. If you are using a mouse, simply position the mouse cursor on the menu 
or command name and click on the left mouse button. 

Before you can assemble a file, you must load it into the workspace. To do this, 
pull down the File menu. When you do. your screen will look like figure 5.3. 

Select the Open command: From the displayed list of files in the current 
directory, select SUMS.ASM to load it into the workspace. Once the file is loaded, 
your screen should look like figure 5.-4. 
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Fig. 5.4. Programmer's Workbench with SUMS.ASM loaded in !he workspace. 
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(Jupu r *> l King Microsoft's Assembly Ianguagc^Prfxluct* 115 

t 

first option^of^i^ a Hle% aWCmb, V Ht fi,t ScltCt | hc Makc mcnu and choos< -' «hc 
across all of Microsoft' i ccausc Programmer's Workbench is meant to work 

to assembly language n anRU3gCS ' ,hc ,crm com f>' lc < although not really applicable 
*y tV gc programming, is the proper choice to assemble a program. 

ofwto ill C ifr ur USk ' ,hC Pr0grammer s Work ^nch keeps you informed 
axe notified and o ^ V l™** WCrC cncoun,ered durin 8 'assembly of the file, you 
Z Z and a chancc «o correct them; correct any errors and reassemble 

Workb^irh rfrU finish assembling the program, you can exit the Programmer's 

SUMS OBI vn i? C * C T? nu) ‘ If y ° U IOOlt at your subdircct ory and see the file 
SUMS.OBJ, you have assembled a file successfully. 

Using MASM 6.0 from the Command Line 

nm ” y, ° use from "■« command line is through use of the Ml EXE 
^ ^'a,r MS prompts SUbrOUane ^ * *" y °™n, dish 


to invoke ML.EXE. The following appears on-screen: 

Microsoft (R) Macro Assembler Version 6.00 

Copyright (C) Microsoft Corp 1981-1991. All ri 0 hts reserved. 

usagt: ML | options | filelist | /link linkoptions) 

Hun ‘ML /help* or *ML -?* for more info 

This terse help information lets you know what you need to enter from t k 

““ lm ''° r' MLE f WOrk pro pe r ly Ifyou are iamiliar with older^.oro 
of MASM. nonce that you no longer can work interactively with the assembler Y™ 
must enter a complete command line that ML can work with right away. * 

Examine the help line again. Because everything enclosed in 
optional, at a minimum you need to enter a list of files to process Rcmem^ th ^ 
you do this, ML will assemble the file first and then txy to fink it. Since SUMS.ASM 

onlya subroutine, meant to be called from a C program there is no ooint top ir 

'^r;^ d,UOn of * » •£££££ rnustentcralso 

a rew command-line options that instruct ML to assemble the file onK, , a , j 50 

properly so that „ will work later with a prograT^nen !n C “ d ° " 

To do this, enter the following command line at the DOS prompt: 

ML /C /C * /FoSUMS.OBJ /FI SUMS.ASM 
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. . «,i Un»» i-x icilv as it is shown here. Although 

You should enter the comma instances case does matter for com- 

aocer- and lowercase don't matter in some msianccs. ease a 

mand-line options (they must be entered exactly as shown). 

The command options you ha« jus. entered are covered in detad In the next 

section. Basically, this is what they mean; 

Compile only, do not link 

Maintain case of labels in source file 

Save object file in SUMS.OBJ 
A Create a listing file 

When you enter the command line and press Enter, ML starts its work. You *ee 
a single Un/suting that the file is being assembled. If there are no " 

returned shortly to the DOS prompt. If the assembly was successful, you see noo 

messages, and the file SUMS.OBJ is in your subdirectory. 

If there are errors, you see a message indicating the type of'ero“ 
is located. If you receive any error messages, you must correct *e*m« before 
continuing. Check your source file (SUMS.ASM) against the hsttng file (SUMS.IST). 
correct any errors, and try the assembly process again. When you have corrected all 
the errors, you can proceed with this chapter. 


/ c 
/ Cx 

/FOSUMS.OBJ 

in 


Assembler Options 

You can use a number of parameters (referred to as options or switches in the 
documentation) with ML to alter the way the program functions. You enter these 
options directly from the command line. 

Remember the following syntax line 
usage: ML l options ) filelist l /link linkoptions] 
that appeare J when you entered only the ML command at the DOS prompt? 

With previous versions of MASM, you could enter command line options at any 
point on the command line. Now, however, because the ML program is used also to 
control the linker, you mud" place all your assembler command options before the 
files they will affect. If you plan to assemble several source files with the same 
command line, and you have different options you want used with each file, you can 
enter them in the following manner: 

ML (options] filelist [options] filelist [options] filelist 
The individual options apply only to the files that follow them. 

The 46 command-line options possible for ML are listed in table 5.1, and 
detailed in the following sections. 
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Table AIL cotntncinddinc options. 

Option 

Meaning 

/? 

Display help information. 

/AT 

Assemble as a COM file. 

IB\filename 

Specify alternate filename as linker. 

1 c 

Do not link; assemble only. 

/Cp 

Do not ignore case differences of user identifiers. 

/Cu 

Convert all user identifiers to uppercase. 

/ Cx 

Do not ignore case differences in PUBLIC and 

EXTERN symbols. 

IDname*text 

Define an identifier, assigning text to name. 

/EP 

Output first-pass listing to STDOUT. 

/F size 

Override stack size. 

/Fbfilename 

Create bound executable file. 

IFefilename 

Vise filename for the executable file. 

/FI filename 

Create a source listing file using filename AST. 

/Fm filename 

Create a linker map listing file using filename.M\?. 

/Fofilename 

Create an object file using///erurote.OBJ. 

/FPi 

Generate math emulator fixups. 

/F rfilenama 

Create a source browser file using/i7e/u>me.SB!L 

/FRfilename 

Create an extended source browser file using 

• 

filename.SBIL 

/6c 

Use FORTRAN/Pascal/BASIC calling ard naming 
conventions. 

/Qd 

Use C calling and naming conventions. 

/Hmajr 

Limit number of significant characters in EXTERN 

• 

symbols. 

/help 

Extended ML help information. 

11 pathname 

Override default indude-file path. 

/link 

Pass options to the linker. 

/nologo 

Do not display copyright message. 

/Sa . 

Generate complete listings. 

/Sf 

Generate optional first-pass listings. 

/ Sg 

Generate listing of assembler-generated code. 

coaii/UHn 
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Table 5. /. continued 


Option Meaning 


ISlwidth 

Set line width for listings. 

/ Sn 

Exclude symbol table from listings. 

/Sp lines 

Set page depth for listings. 

/Sstext 

Set listing subtitle to text. 

/Sttext 

Set listing title to text. 

/ Sx 

Include false conditionals in listings. 

/Ta filename 

Assemble file without ASM extension. 

/VM 

Enable virtual memory. 

/w 

Set warning level 0. 

/w level 

Set warning level to level (0,1, 2, or 3). 

/wx 

Treat warnings as errors. 

/X 

Igno. " the INCLUDE environment variable. 

/Zd 

Include line numbers in object file. 

/Zf 

Make all symbols PUBLIC. 

/Zi 

Create CodeView-compatible file. 

/Z HI 

Force compatibility with MASM 5.1. 

/Zpboundary 

Pack structures to byte boundary (1, 2, or 4). 

/Zs 

Check syntax only. 




You must include a delimiter before the first letter of each option. This 
delimiter can be either a slash (/), as shown in table 5.1, or a dash (-). MASM does 
not differentiate between the two symbols. 

As you can see from table 5.1, many command-line options have variables you 
can specify {width, lines, and filename, for example). One way that specifying 
options for ML differs from specifying them for other programs, such as LINK, is that 
with ML there arc no colons between the option and the variable for the option. 
Instead, the variable immediately follows the option. The only exception to this is 
the /F option, in which a space between the option and the numeric variable is 
mandatory. 

Let's look at each ML option in greater detail. 
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Display Help Information (/?) 

are [hlsTwh^n/ *1* UMne ML ' ),ou fo, 8 M what the syntax or command-line options 

displayed on-screen”' ^ “P’ Wh '" *° U USe - «"** “ 

• • 

C:\MASM60>Ml /? 


ML | /options ) filelist ( /link linkoptions 1 


/AT Enable tiny nodal (.COM file) 
/Bl<linker» Use alternate linker 
/c Assemble without linking 
/Cp Preserve case of user identifiers 
/Cu Map all identifiers to upper case 
/Cx Preserve case in publics, extents 
/D<name>(«text] Define text macro 
/EP Output preprocessed listing to stdout 
/F <hex> Set stack size (bytes) * 

/Fb(file] Generate bound executable 
/Fe<file> Name executable 
/FI(file) Generate listing 
/Fm(file) Generate map 
/Fo<file> Name object file 
/FPi Generate 60x87 emulator encoding 
/Fr(file) Generate limited browser info 
/FR(file] Generate full browser info 
/G<c!d> Generate Pascal or C calls 
/H<pumber> Set max external name length 
/?<name> Add include path 
/link <linker options and libraries> 


/nologo'Suppress copyright message 
/Sa Maximize source listing 
/Sf Generate first pass listing 
/Sl<width> Set line width 
/Sn Suppress symbol-table listing 
/Sp<length> Set page length 
/Ss<string> Set subtitle 
/St<string> Set title 
/Sx List false conditionals 
/Ta<file> Assemble non-. asm file 
/VM Enable virtual memory 
/w Same as im /WX 
/WX Treat warnings as errors 
/W?number> Set warning level 
/X Ignore INCLUDE environment path 
/Zd Add line number debug info 
/Zf Make all symbols public 
/Zi Add symbolic debug info 
/Zm Enable MASM 5.19 compatibility 
/Zp[n) Set structure alignment 
/Zs Perform syntax check only 


On this help screen, items such as <f ile> are mandatory, whereas those like (file) 
are optional 


Assemble as a COM File (/AT) 

This option causes assembler to make sure that you have not programmed 
inconsistently with a program designed to be a COM file. For instance, the entire 
program (code and data) must reside in a single segment. The effect of this option 
is the same as that of using the .MODEL TINY directive in your program. 

If you do not use the / c option, /XT causes the linker to be invoked with the 
/T option. 
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Specify Alternate Linker (/Bl [filename) 

ml automatically invokes the linker after the assembly process is complete, tf 
you do not want to use the UNK program as your linker, th.s option allows you to 

specify a Afferent program. 


Assemble Only (/c) 

If you do not want to link your file, use this option, which causes ML to 
only. This option does not result in the creation of an OBJ file on disk, 
however; you must use the /Fo option /or that. 

Do Not Ignore Case Differences 
of User Identifiers (/Cp) 

Normally, ML treats all identifiers (names of variables and procedures) the 
same, converting them'all to uppercase. Some high-level languages are not insensi¬ 
tive to case; they treat an A differently than an <*. If this is the case (no pun intended), 
you can-use this option to direct ML to maintain the original case of your identifiers. 


Convert All User Identifiers 
to Uppercase (/Cu) 

This is the default setting for ML It is included for those instances in which you 
are assembling several files and the first may require the use of /Cp, whereas the 
second can be set back to the default case identification. 

Do Not Ignore Case Differences 
in Public and Extern Symbols (/Cx) 

This modified version of the /Cp option results in special treatment only for 
identifiers that will be seen by other programs. An identifier private to a particular 
procedure is still converted to uppercase. 

This option should cause your routines to work with most high-level 

languages. 
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Define an Tdentifier ( jX^nume^text ) 

can corn^i^ hanriv"^'* 1?°^ aSSCmb,y dircaivcs in y° ur Program, this option really 
° ‘n handy. It allows you to define an identifier at the time you use ML. Thus 

Assembled S ' 8n * ^ Va,Ue l ° a bbd lha ' «**«* the program Ju be 


r CX * mp “son'c that some special code included in your program has 
rt . ,n ® °. n y whcn the program is being debugged. If these instructions are 
» ion , being included only when the identifier debug is set to yes, including the 
option /Ddebug-yes will cause the code to be included. 


Output First-Pass Listing to STDOUT (/Ep) 

^‘ S °P tion ca n be a bit confusing. As you may recall, MASM 6.0 processes files 
differently than previous versions of the assembler. Because it is now a single-pass 
compiler, references to “first pass" or "second pass" lose their meaning. This option 
does nothing more than provide an elemental listing of the assembled file before 
final resolution of all source-file elements It does not give as detailed a listing as the 
/FI option used with the/S options. 

If you choose this option, a listing that has macros and most identifiers 
expanded, and the original macro definitions removed, is sent to STDOUT (usually 
the screen). This listing can be helpful in determining how to fix some pesky errors 
that can crop up during the assembly process. 


This option is not the same as other listing options such as /FI. If you want to 
save the output of this listing, you must use redirection to capture output to a disk 
file or send it to the printer. 


Override Stack Size (/F size) 

This option does nothing in ML itself. It causes the linker to be invoked with 
the /ST option set to the suck size (in bytes) you specify. The space between the 
option and. the size is mandatory. 

Normally, LINK determines the stack size in the finished program based on any 
stack declarations in the OBJ file. The /ST. size option overrides this value. 
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Create Bound Executable File 
(/Fbfilename) 

If you are using ML to create OS/2 programs, this option causes ML to create 
and link an OS/2-compatiblc program and then invoke the BIND utility. This utility 
modifies the executable Ole so that it will work under OS/2 as well as DOS. 


Specify Executable File (/ Fefilename ) 

The file name specified with this option is passed to the linker as the name of 
the final EXE or COM file. ML does nothing except pass it on. 


Create a Source Listing File (JFXfilename) 

This option enables listing capabilities in ML. It causes a listing Ole to be 
created, appending the .LST extension to the name you supply. 

Several other options affect the way ML creates the listing enabled by this 
option. For more information on this topic, see the options /Sa, /Sf, /So, /SI, /Sn, 
/Sp, /Ss, /St, and /Sx. 


Create a Map Listing File (JFmfilename) 

This option is passed on to the linker so that the linker can create a listing Ole 
(referred to as a MAP Ole) while linking. For more information about map files, see 
Chapter 4, “Choosing and Using Your Linker." 


Create an Object File ( '/Fofilename ) 

U nless you specify this option, ML does not save the work done in the assembly 
process. If you plan to use ML and to go direcdy to an EXE or COM file, you probably 
wont want to use this option. But if you are creating subroutines to link later or if 
you are building a library, you will use this option quite a bit. 


You must provide a file extension when you use this 
extension is not used automatically. 


option. The .OBJ 
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Generate Math-Emulator Fixups (/Fpi) 

different NPX chips. Tlie'assemblerdT'' l,lt th * ‘'“"'"S'P 0101 capabilities of the 
ate included when the object code u t V? C °. nwin ,he emu lation routines; they 
Vour high-ieve. ianguage (Microsoft C. for 

compatible compmer^rej^rdiess of e^eAer you^ have an npx* Cxcculcd “ 
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Create a Source Browser File 
(/Fr filename) 




Create an Extended Source 
Browser File (/FF filename ) 


mefs Workbench'T"* 5 “ “ ended venion of SBR for use with Program- 

mer s Workbench. See the information provided for the /Fr option. 


Use FORTRAN/Pascal/BASIC Calling 
and Naming Conventions (/Gc) 


This option sets the parameter-passing conventions used by ML when assem- 
bUng a program. You can use this option to specify not only how parameters are 

bUt 4,10 hw 'Nr « returned to the calling high-level 

This option is equivalent to the following directives: 


OPTION LANGUAGE:PASCAL 
OPTION LANGUAGE:BASIC 
OPTION LANGUAGE:FORTRAN 
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Use C Calling and Naming 
Conventions (/Gd) 


This option sets the parameter-passing conventions used by ML when assem¬ 
bling a program. You can use this option to specify not only how P aran ™ et ^J" 
passed to your routine but also how they are returned to the calling high-level 

language program. 

This option is equivalent to the OPTION LANGUAGE :C directive. 


Limit Significant External Symbol 
Characters (/H max) 

Some high-level languages limit the number of significant characters in 
procedure names or variables. This option tells ML to set a limit on how many 
characters are significant. Valid lengths are anywhere from 1 to 255 characters. 

With this option set, ML disregards anything longer than the maximum you set. 
Therefore, ML checks to sec that there are no duplicate symbols (the firs: max 
characters are the same, where max is the maximum significant length). 


Extended ML Help Information (/help) 

This option causes ML to load the QuickHelp utility program and display 
extended help information in an interactive format. 

V. 

Override Default Include-File 
Path (/I pathname) 

This option instructs ML where to search for include files in the source file. 
These are files pulled in during assembly through use of the INCLUOE directive. 
Typically, these include files are stored in a single directory that is specified with an 
environment variable. For instance, if your include files are stored in the subdirectory 
VMASM60MNCS, you can use the DOS command 

SET INCLUDE=\MASM60\INCS 

to instruct ML where to look for the files. The /1 option overrides this environment 
variable and tells ML where to look first for include files. 
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If your include files are spread among several directories, you can use multiple 
/1 options to specify different directories. Each director)' is searched in turn until the 
necessary include file is located. If, after each directory has been searched, the 
required include file is not found, an error is generated. 

See also the /x option. 


Pass Options to the Linker (/link) 

This should be the very last ML option on the command line. ML assumes that 
anything to the right of this option should be passed directly to the linker. You use 
this option to pass linker commands at the time you start ML. 

I , * 

Clearly, this option has no meaning if used with such options as /c or /2s. 


Do Not Display Copyright 
Message (/nologo) 

Normally, a copyright message displays when ML first starts. Including this 
option on the command line suppresses the copyright message. Unlike the corre¬ 
sponding option in LINK, this option does not have to be the first on the command 
line. 


Generate Complete Listings (/Sa) 

This option, which instructs ML to include (in the listing file) everything it can, 
is equivalent to using /FI with all the ofher enabling options such as /Sg and /Sx. 

This option has no effect on output produced with the / EP option; additionally, 
you must use /FI for this option to have any effect. 


Generate Optional First-Pass Listings (/Sf) 

This option causes the first-pass listing information to be included at the 
beginning of the listing file. (The same information is displayed when the / EP option 
is used). 

« 

This option has no effect if the IF 1 option is not used. 
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Pan I: The Funda mentals of Assembly language __ 

Generate Listing of Assembler-Generated 
Code (/Sg) 

Normally, ML does not include assembler-generated code in a listing file. This 
assembler-generated code includes code generated with the . IF, .WHILE, .STARTUP, 
and INVOKE directives. This option causes the code to be included in *he listing. 

% 

Set Line Width for Listings (/SI width) 

Using this option is the same as using the page directive in your source files. 
Whereas the PAGE directive allows you to specify both the length and width of your 
listings, this option allows you to set a line width only. (See also the section about 
the/Sp option.) 

This option has no effect on output produced with the /EP option, and has no 
effect if the /FI option is not used. 


Exclude Symbol Table from Listings (/Sn) 

When creating a listing file, ML normally includes a complete symbol table. This 
option causes the symbol table to be excluded. 

? This option has no effect if the /FI option is not used. 


Set Page Depth for Listings (/Sp lines) 

Using this option is the same as using the PAGE directive in your source files. 
Whereas the PAGE directive allows you to specify both the length and width of listings, 
this option allows you to set a page length only. See also the section about the /SI 
option. 

This option has no effect on output produced with the /EP option, and has no 
effect if the /FI option is not used. 


Set Listing Subtitle (/Sstexf) 

Using this option is the same as using the SUBTITLE directive inyour source file. 
It allows you to specify a string that will be included as the subtitle on listings (file 
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quotation marks^See also V >,1,am! ‘ * pawf# ' > ou mus « enclose the text .string in 
mares, !>ee also the section about the /St option. 

eBect^e ^TopHon^not'u«d OU,PU ' produt,:<l wi,h ,he /EP op,ion »>« no 


Set Listing Title (/St text) 


You effcC * “ “ Sing ,he IITLE direc,ivc your source file, 

(file orprintedl S ' nn8 Wi " appcar at the head °f every Page in a listing 

S~ also the section 

cffect^e OP FTop h ttonis t noiused OU ' PU ' Pr ° dUCtd W " h ' he '* ° P,i ° n ' and h “ no 


Include False Conditionals in Listings (/Sx) 

This option has the same effect as the . listif directive. It causes source-file 
lines that were not conditionally assembled to be included in the listing file. 


Assemble File without ASM Extension 
(JTzfilename) 

Normally, ML expects source files to have the ASM extension. If you provide a 
different extension, ML tries to invoke a different compiler to handle the file. 

This option lets ML know that you really intend it to work with a file whose 
extension is not ASM. This option can be used several times on a command line 
because it applies only to the file name immediately following the option. 


Enable Virtual Memory (/VM) 

If you run out of memory when assembling a large program, use this option. 
It instructs ML to use virtual-memory techniques while assembling. These tech¬ 
niques allow ML to use EMS, XMS, and disk space (in that order) to store information 
needed for successful assembly of the program. 
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Set Warning Level 0 (/w) 

issuing .his option is the same as issuing the im option; i. suppresses all 
warning messages during assembly. 


Set Warning Level (/W level) 

ML uses /we, /W1, or /W2 to provide control over which warning messages are 
displayed during assembly. The /W0 option suppresses all warning 
/wi P option suppresses advisory messages but displays senous messages, and the 

/W2 option displays all messages. 


Treat Warnings as Errors (/WX) 

TvDicallv, the difference between warnings and errors is only a matter of 
degree With warnings, however. ML can stiff generate an OBJ file and proceed with 
linking; with errors, it cannot. This option instructs ML to treat each w ». rn ‘"« “' f " 
were an error; /wx will stop an OBJ file from being created and stop linkmg from 

occurring. 


Ignore the INCLUDE Environment 
Variable (/X) 

Typically, you set an environment variable to specify where ML should look for 
include files. For instance, if your include files arc stored in the subdirectory 
\MASM60\1NCS, you can use the DOS command 

SET INCLUDE=\MASM60\INCS 

to tell ML where to look for the files. The /X option overrides this environment 
variable and tells M L not to look in the subdirectory set by the SET command. Rather, 
ML looks in the current directory only. If the required include file is not found, an 
error is generated. 

If you want to specify other directories where the include files are located, sec 
the /I option. 
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Include Line Numbers in Object File (/Zd) 

If you are working with a large program, and running out of memory when you 
subsequently use CodeView^ this option may help. It limits the amount of CodeView- 

specific information stored in the OBJ file. Thus, less memory is required when you 
use CodeView. 


Make All Symbols Public (/Zf) 

This option tells ML to pass all symbols that specify memory ad dresses into the 
OBJ file as PUBLIC symbols. Its use simplifies debugging with programs such as 
CodeView and Turbo Debugger, which can identify any PUBLIC symbols by name. 
Without this option, only identifiers declared expliddy as PUBLIC are considered 
public. 


Create CodeView-compatible File (/Zi) 

This option causes line-number information and symbolic data about all labels 
and variable names to be included in the OBJ file. Including this data allows for full 
operation of the symbolic debuggers, such as CodeView or Turbo Debugger. 


Force Compatibility with MASM 5.1 (/Zm) 

.This option is the same as using the option M5ie directive in your source file. 
It instructs ML to assume that your program uses the same structures allowed tor 
MASM 5.1. Because these structures were more limited, you probably will not use 
this option unless you encounter errors when you try to assemble your program. 

• 

Pack Structures to Byte Boundary 
(JLpboundary) 

When creating structures you have defined in your p ro gra m, ML typically 
places adjac ent sourcc-cpde fields immediately next to each other in the OBJ file. 
This option allows you to specify a byte boundary ML should use when aligningfields 
in your structures. 
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The only proper alignment value, are 1.2, and 4; in effect, the* values specify 
the minimum Held length for structures. Fields shorter than the minimum specified 
length arc padded (from left to right) with zeros to the necessary boundary. 


Check Syntax Only (/Zs) 

If all you want to check is whether you have coded your program correctly 
from a syntactical standpoint, use this option. It results in no OBJ file being created, 
and does not invoke the linker. Messages arc displayed only if errors exist. 

Compatibility with MASM 5.1 
Options 

Another way to assemble programs with MASM 6.0 is to use the MASM program. 
Invoking the assembler this way should be familiar to programmers who have used 
older versions of MASM. 

When you use MASM, all that happens is that the oldcr-syntax command-line 
options are translated into the appropriate options for ML, and the ML command is 
issued. Table 5.2 shows how these options are translated. 

Table 5.2. MASM 5.1 options and equivalent options in MASM 6.0. (Options 
with no equivalent are ignored in MASM 6.0.) 


MASM 51 
Option 

MASM 60 
Option 

/A 


/B blocks 


/c 

/FR 

/D 

/FI /Sf 

lOx 

ID 

/E 

/FPi 

/H 

/help 

Ilpath 

/Ipath 

/L 

/Fl 

/LA 

/Fl /sa 
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/MU 

ICu 

/MX 

1 Cx 

/N 

/Sn 

If 


IS 


n 

/nolooo 

/V 


IWn 

/Nn 

/X 

/Sx 

IZ 


/ZD 

/Zd 

)Z1 

/Zi 



s,tssr" -2 s * ’■™ ssss 


Change from Alphabetic Segment 
Order (/A) 


^«2!S2i£S^^ 

order or the order in which they occurred in the source file Mlordl phab " ical 
alphabetically within group, and oiler, no way to ch^ “ is Wlen 


Set Buffer Size (/B blocks) 
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Check Purity of 286/386 Code (/P) 

ln MASM ,1. this option «s 

r %&^~*^** - - ,nc,uded ,n your WUKe “ e 

Order Segments by Occurrence 
in Source Code (/S) 

We . 

specify a different ordering scheme. 

Show Extra Assembly Statistics (/V) 

, MASM 5 1 thU option turned on the assembler s verbose 
caused'addlttoMi statistics^,0 be generated when the file was assembled. MASM 6. 
has no equivalent command. 

Display Error Lines (/Z) 

errors br specific source-code line. 

Using ML through a Batch File 

To make the assembly process easier, you can set up a batch hie (as 
many other development commands and programs). The tat 
is to determine which command-line options you want to use regularly whe yo 

assemble your files. 

The following batch file (called ASM.BAT) is one 1 routinely use to assetn e, 
using the ML command line: 
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:LOOP 


REM . 
IF %1/ 


CHECK IF NO FILES AVAILABLE ON COMMAND 
*' / GOTO DONE 


LINE 


«■"«* IF PENSION (.ASM) WAS ENTERED 

if mot exist %i Soto chkext 

ECHO Could not MOMblo .. 1 , contained an aatanalon 


.‘CHKEXT 

REM • CHECK FOR ROOT PLUS ASSUMED EXTENSION 
IF NOT EXIST %1 .ASM GOTO NOT-FOUNO 
ECHO Assembling ... %i .asm 
ml /c /Cx /Fo%l.obj /FI tl.asm >NUL 
IF ERRORLEVEL 1 GOTO ERROR 
GOTO NEXT 


:NOT-FOUND 

REM - FILE NOT LOCATED 

ECHO Fils %i Not Located or Found iA Currant Directory | 
GOTO NEXT 


:ERROR 

ECHO Error detected Miile assembling %i 
:NEXT 

REM - CONTINUE WITH NEXT FILE • END OF LOOP 
SHIFT . 

GOTO LOOP 

:DONE 

ECHO All Files have been Assembled I 
With this file, the assumption is that you will enter the command line as 
ASM fiief fll02 fU»3 ... 

where filef, file2, files, and so on are the names of the source-code files to be 

assembled. Do not enter the ASM extension, because ML can generate an object file 

only if you specify a file name to use for that file. Thus, If you enter a file name with 
the ASM extension, such as FILEASM, the batch file tries to create an object file with 
the name FILE ASM .obj, thereby generating a DOS error. 
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If ASM.BAT can be located in the current search path, you can use It from any 
subdirectory. The source-code file should be in the current directory, however, and 
the OBJ file will remain in the current directory. 

Notice the line in the batch file that does all the work: 

ML /e /Cx /Fo%i.obJ /FI %i.«m >NUl 

This line must be entered in the batch file exactly as you see it, because ML is case- 
sensitive on command options. 

The benefit of using ML from a batch file is that you don’t have to worry about 
entering the command-line options every time you want to use the assembler. I use 
a few options (such as /e, /Fo.and /Fl) regularly, and would quickly tire of entering 
them manually. This batch file overcomes that problem. 

If you find that you routinely use other command-line options, change the 
batch file to reflect your needs. 


Using ML with Error Codes 

In earlier versions of MASM, the assembler returned an error level when 
completed. This was handy for use with batch files, where the error level could be 
tested and acted upon. Table 5.3 lists the exit codes (and their meanings) possible 
for MASM version 5.1. 


Table 53- MASM 5.1 exit codes. 

Code Meaning _ 

No errors detected 
Argument error 
Cannot open source file 
Cannot open 1ST file 
Cannot open OBJ file 
Cannot open CRF file 
Cannot open INCLUDE file 
Assembly error 
Memory-allocation error 
Unused 
10 option error 
Interrupted by user 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 
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Although the ML assembler in viacm / n 

ality of .his error level is much less than in '7° r lev « 1 ' ">« '“"aion. 

only two significant error levels are returnJt ° n MASM ,ncarnat ‘ons. Basically, 

"•TT* durin8a “ emb, » if > -—3 -'EXXJZSZZ 

methods inyour batch flte^ouan^w'this^ft^d'“t** *“* ""“"“"“'V control 
will function. This exit code is used ■* . T “ control how *0 batch file 

£*• Zh ' 

can be quite elaborate in your imple^en^i^ BU< V ° U 

,owird the us * ° f 


Meanwhile, Back at 
the Program... 


opUo^Tl! ” Ihe^rnTp^^^^ha COnU "“* ,i "' 

^nbled SUMS.ASM earlier this h^^^dot 

n^e R r.™“^ c ss? ;™i c prog r «* ■ 

doing some testing). After you enter th^n^^Ih nTS" **Z *" 
code file cafied TBST.OBJ. „ should com^di^K^^r^ 

i t C« 1 A a as v as 


/• File: 

• Author 

• Dete: 


TEST.C 
Allen L. Wyatt 
8/3/91 


* Purpose: Progran to test the calling of SUMS() 
•Include <stdio.h> 


•xtern short suns(short); 
•hort status(short); 
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■hort *t*tu*(*hort oriQ) 

{ unsigned short now; 
nafMuas(orlg)i 

If (orig>9 U n«w--0) cioacity (%« row* i* too many)\n\orig); 

(printfCSorry, th. .«• ha. c,ptclty * 

> 

(printf(*Th* *u® of %u row* 1* %u\n'.orig.n*w)i 

> 

r*turn (now); 

> 


void Mln() 

{ unsigned *hort ]• *» 

j r |j 

•hilt (J1-999) 

< printfCInitial valu*: '); 

acanf C%u , .*J)i 
if (Jl-09«) 

{ x-statua(j); 

> 

for (1-1» *"1( x=status(!♦♦)) 


’ Thi5 simple program perform* th^origtaaTaneTderived 

number that i. theprognunexiu.be 

number are displayed, bccond. y { starting at 1, that displays values 

interactive portion and of SUUS<). You may remember from 

and derived values until It re ^ reach ed when the derived value is greater than 
earlier in the chapter that returns a 0 and terminates execution of 

65,535. Whendti* limit iseKeeded.^" «tums 

the controlling C program. 


Linking TEST.OBJ and SUMS .ASM 

th*. linker can be used in several ways, the principal ways being interactively 
or widTjust * command line. Let's look first at using the linker interactively. 
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Using LINK Interactively 

® n< ;f 1°" h i' c ,hc object-code file*. TEST.OBJ and SUMS.OBJ. you are 
. n 1 c ^ cs * Ma ^ *ure that these (liesare In the current directory. You 
. _ access also to LINK.EXE, either in the current directory or in the search 

pstn. To start the linking process, enter the following at the DOS prompt: 

LINK 

When you press Enter, you will see a notice and prompt similar to the following: 

Microsoft (R) Segmented•Exscut able Linktr Vsrslon 5.13 
Copyright (C) Microsoft Corp 1084 - 1091 . All rights rsssrvsd. 

Object Modules |.OBJ]: 

The linker is waiting for you to specify the flies to be linked. The default answer 

is shown In brackets; the linker accepts this answer if you simply press the Enter key. 

toot names of the files to be linked, separated by either a space or a plus 
sign (+). Because the linker assumes an extension of OBJ (unless you override it), 
you need to specify only the root names. When you make the proper entries, the 
following message should appear: 

Object Modules (.OBJ): test sums 
Run File (test.exe]: 

Notice that the linker now prompts you for the name of the EXE file to create. 
(The EXE file is the executable run file LINK.EXE creates.) Use the default, test. exe. 
When you press Enter to signify that you accept the default, the linker asks the 
following: 

. Run File (test.exe): 

List File (NUL.MAP): 

A list file is optional, as the default (NUL.MAP) indicates. List files for the linker 
have the extension MAP because they provide a "map" showing how the linker did 
its work. For now, enter test to indicate that you want a list file named TEST.MAP. 
When you do, the following prompt is displayed: 

List File (NUL.MAP): test 
Libraries (.LIB): _ 

LINK needs to know which library files to use for external references that cannot be 
resolved fgpm within the object-code files. (Libraries are covered in Chapter 9. 
"Developing Libraries ") Although there are no assembly language libraries for this 
sample, LINK will look for a C library it needs to complete the linking process. 

If you just finished compiling your C program, chances are that LINK will 
search and find the appropriate C library automatically. If you did not just finish 
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compiling the C program, you may want to make sure that the library environment 
variable (typically LIB) is set to the proper search path for the C libraries. To do this, 
you have to abon the linking process, change the environment variable, and start 
linking all over again. 

When you are ready, simply press Enter to indicate that no explicit libraries are 
to be used. The following prompt is displayed: 

Libraries [.LIB]: 

Definitions File (NUL.DEF): _ 

• 

LINK is asking for a module-definition file. This file—used only when creating 
programs for OS/2 or Windows—is used to describe the name, attributes, system 
requirements, and other characteristics of an application program. Because you are 
creating a simple DOS-based program, just press Enter. 

Now LINK has asked (and you have responded to) its five questions. Notice that 
your disk drive is active for a short time, and then the DOS prompt returns. The 
return of the DOS prompt indicates that the linking process is complete, and that no 
errors occurred. Had an error occurred, an error message would have appeared 
during linking, indicating the type of error and the source file for the error. 

If you receive any error messages, you must correct the errors before continu¬ 
ing. Check your files against the listings in this chapter; then try to assemble, 
compile, and link again. After you have corrected the errors, you can proceed with 
this chapter. 


Using the LINK Command Line 

As mentioned earlier, you can use LINK also from the DOS command line. You 
can enter any or all of the responses to individual prompts direedy after the LINK 
command. For instance, entering either of die following lines produces the same 
results as those achieved in the last section: 

LINK TEST SUMS,.TEST,; 

link test+sums,,,; 

Remember that LINK asks five questions during an interactive session. The 
parameters in either of these command lines provide answers to the questions. • 
The parameters are separated by commas, and the line ends with a semicolon. 

•As the three consecutive commas indicate, some parameters arc left blank. In 
this case, LINK uses the first parameter (TEST) as the implied parameter. 
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line: f0 " 0Win * Syn,1 “ ‘ S U$ * d '° * n,cr P arame " ; '» “"*ctly from (he command 

LINK obj.ext.map,Hb.dtf 

^^P^^*** parameter designates. 

using tuA;aa'the'parameterfor'ih 0 ^ "°** panicular Wc of (lie? Simply by 
commands In,,™ UNK ,o cjTan^e bu, 'ZSSm? " ^ 

LINK TEST SUMS..NUL; 

LINK TEST+SUMS,; 

cflec^T^^ ^ C °T mand linc ' a,,hou « h Sorter Ihe Am is 

Sijr-jir* - ins,n,c,s l,nk *° ^ *—• 


Using the LINK Response File 

y ° U can r **P° nd the four UNK questions in a Ale. logically called a reslyn,,,.. 
^TWs is a good way ,o use UNK when you know that you till be Unking 

ssz “n urin8 dev ' ioprncn,; «** ~ 

whh 2™:** melh0d °t PrOV J dine inpu< to L,NK -««■* a normal ASCI, tea file 
«ith any name you want, that has the answers to each question Each auATuwJ 

answer should be on a separate line. Forinsunce, using our Ampl! D ™^m, ,he 
response file would have only four lines: »">P‘e programs, the 

TEST SUUS 
TEST 


UNK uses this response Ale to Unit TKST.OUJ and SUMS.OBj. producing the 

t C ‘ mT £XE ^ ' i5 ' fi,C TES ™ AJ> “ "O 

cro»X a r"* f “ e W ‘ ,h UNK ' UNK * -* -he following 

LINK v _ 

duAdThrf? b ** ,h * -eaponse Ale UNK Is to use. Notice the • symbol 

. * OTt lhc ** lc name - ; **ymbol is the signal that UNK needs to differen¬ 

tiate between a response Ale and.. source file. 
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If the sample response file is name.1 TEST I.NK. the following command will 
run l-INK and provide input to LINK from the response file: 


LINK 6TEST.LNK 

The more you use LINK, the better you will understand the value of using 
response files. 

Testing the Finished TEST.EXE 

Now that your linker has created TEST.EXE. you can try your program to see 
whether It works Enter the following at the DOS prompt to start execution of the 
program: 

TEST 

The result should be a prompt asking you for an initial value. Enter an integer 
number, such as 7. You have just asked TEST to calculate the number of blocks in 
a seven-level pyramid, similar to the one in figure 5.5. 


Fig. 5.5. A seven-/etvi pyramid. 


The program dialogue and results should look like this: 

C:\>TESf 
Initial /alua: 7 
Tha sun of 7 rows ia 26 
Initial Valua: 

When you press Enter after entering the initial value, the response indicates 
that there are 28 blocks in the pyramid (7 + 6 + 5 *■ 4 + .* + 2+1 = 28). This program 
is designed to corn «nue asking for values and rctui "ing results until you enter a value 
of 999. Then the program will generate a list showing the initial values and resulting 
values for pyramids between one row high and the maximum number of rows the 
program ean handle. A partial program dialogue f. -How v 
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C: WEST 

Initial Value: 7 

The sum of 7 rows is 28 

Initial value: 5 

The sum of 5 rows la 15 

Initial Value: 22 

The sum of 22 rows it 253 

Initial Value: 183 • 

The sum of 103 rows la 5356 
Initial Value: 999 
The sum of 1 rows is 1 
The sum of 2 rows is 3 
The sum of 3 rows is 6 
The sum of 4 rows is 18 
The sum of 5 rows is 15 
The sum of 6 rows is 21 
The sum of 7 rows is 28 * 

The sum of 8 rows is 36 
The sum of 9 rows is 45 
The sum of 18 rows is 55 

(Intermediate values have been deleted to conse.ve space.) 

The sum of 353 rows la 62461 
The sum of 364 rows is 62835 
The sum of 365 row* is 63198 
The sum of 356 rows is 63546 
The sum of 357 rows is 63983 
The sum Of 358 rows IS 64261 
The sum of 359 rows is 64628 
The sum of 368 rows la 64966 
The sum of 361 rows is 65341 

Sorry, the sum has axceeded capacity (362 rows is too many) 

C:\>_ 

Notice that the upper limit the routine can handle represents a 361-row 
pyramid. A 362-row pyramid contains63,703 blocks, a number too large to be stored 
In the unsigned integer used to return values from the assembly language subrou¬ 
tine. 
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Summary 

This chapter covered the use of the major assembly language products from 
Microsoft: MASM 6.0 and UNK. These products represent the lion s share ol the 
assembler marketplace. You have used the assembler and linker to create a 
functioning subroutine called from a C program. 

Using an assembler properly is essential to your success in' us '" g 
language. Even though ML (the coromand line assembler within MASM 6X1) h 
rich variety of command-line options available, it is not difficult to use in a basic 
manner. You probably will use the options only In special situations. 

In the next chapter, you learn how to program using Bctfland-S“i* 1 
language products. If you do not plan to use Turbo Assembler (TASM) or TUNK, 
you can skip to Chapter 7, “Debugging Assembly Language Subroutines. 
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Using Borland’s 
Assembly Language 

Products 


V°u ^ ave a,rca<J y beamed many of the differences between 

. issssssasssrjssSSsS 

Microsoft s Assembly Language Products " arp vwv c i_^ ** n 8 

\ 

TASM, a contraction for Turbo Assembler, has been around for several years 
The current version, TASM 3.<vgras introduced in December 1991 i, 
capabilities and feature, than earlier versions, as well as many c^l l" 27 
how you program and use the assembler itself. - . 8 ta 

TUNK has been around a little longer than TASM. It is shinned with th- 
Professional versions of Borland's C and C+ + products, which also indude TAsEl 


I 

A Sample Program 


To proceed through this chapter. ,ou need a sample subroutine to assemble 
Tilts subroutine will be neither large nor complex, nor will it exemplilv the best 
masons for using assembly language. Although writing this ^l£.£l 
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language is easier than writing it in assembly language, I will use it to demonstrate 
how to assemble (and later debug) a subroutine. 

U,-. assume «ha, you need .o de,ermine .he.o£ number £££££ 
pyramid where each ascending row contains one less b 
and the top row contains only one block (see fig 6.1). 




The bottom row contains 15 blocks, the next row contains 14, and so on, stfth 
only one block In the top row. Your job is to calculate the total number of blocks 
needed, given only the number of blocks in the bottom row. You will usilhe sample 

program to do the job. 

The program (SUMS.ASM) is designed to be called from Borland C++. When 
n«sed an unsigned 16-blt integer, this program calculates and returns the result as 
an unsigned Integer. The assembly language subroutine, written for TASM 3.0, 

follows: 

Page 69,132 

Comment { . 


Filer 

Autnor: 

Date: 


SUMS.ASM for Turbo Assembler 3.g 

Allen L. wyatt 

19/15/91 
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Chapter 6 l Sing Borland's Assembly Language Products 


Purpose: 

Format: - 

Given an integer number X,* find the sum of 

X ♦ (XI) ^ (X 2) ♦ (X 3) ♦ (X 4) ... 4 2 ♦ 1 
Designed to he called from Borland (>♦. 

SUMS (X) 

_sums 

PUBLIC _sums 

.MODEL small 

.CODE 

PROC Value:WORD 



MOV AX,0 

'.Initialize to zero 


MOV CX.value 

;Get actual value 


JCXZ S3 

;Nun*0, no need to do 


CLC 

;Initialize for start 

SI: 

ADC AX.CX 

;Add row value 


JC S2 

;Quit if AX overflowed 


LOOP SI 

;Repeat process 


JMP S3 

;Successful completion 

S2: 

MOV AX.e 

;Force a zero 

S3: 

RET 

;Return to C 

_su«s 

ENOP 



ENO 



If the number entered results in a sum that is greater than 65,535 (the largest 
unsigned integer number that can be held in 16 bits), the subroutine sets the result 

to 0. 

Go ahead and enter this program. After you finish, save it as SUMS ASM. You 
are now ready to assemble the program. 

Using TASM 3.0 

Before beginning the assembly process, make sure that you have insulted 
TASM 3.0 according to the instructions that came with the software. Make sure that 
SUMS ASM (the subroutine file) is in the current disk directory. At the DOS prompt, 
enter 

TASM 
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to invoke Turbo Assembler. The following information is displayed: 

Turbo Assembler version 3.0 Copyright (c) 1988, 1991 Borland International 
Syntax: TASM (options) source (.object) (.listing) (,xref) 


^ a »^ s Alphabetic or Source-code segment ordering 

Generate cross-reference in listing 
/dSYM(=VALJ Define symbol SYM » 0, or - value VAL 
^ e '^ r Emulated or Real floating-point instructions 

^h,/? Display this help screen 

/iPATH Search path for include files 

/jCMD jam in an assembler directive CMD (eg. /jIDEAL) 

Hash table capacity # symbols 

/1 » /la Generate listing; l»normal listing, la=expanded listing 

/ml,/mx,/mu Case sensitivity on symbols: ml=all, mx=globals, mu=none 
/mv# Set maximum valid length for symbols 

,m * Allow n multiple passes to resolve forward references 

/ n Suppress symbol tables in listing 

/o,/op Generate overlay object code, Phar Lap style 32-bit fixups 

/p Check for code segment overrides in protected mode 

/Q Suppress OBJ records not needed for linking 

/t Suppress messages if successful assembly 

/uxxxx Set version emulation, version xxxx 

/w6,/w1,/w2 Set warning level: w0=none, wl=w2=warnings on 

/w-xxx./w+xxx Disable (-) or enable (♦) warning xxx 

/x Include false conditionals in listing 

U Display source line with error message 

/zi,/zd. :n Debug info: zi=full, zd=line numbers only, zn^none 

Jhis terse help information tells you what you need to enter from the 
command line to make TASM.EXE work properly. You must enter a complete 
command line that 1 ASM can work with right away. " 

Examine the help information again. Everything enclosed in brackets is 
optional; the least you need to enter is the name of a source file to be proc 
Thus, if you enter the following command line: 

TASM SUMS 

Turbo Assembler will dutifully assemble SUMS.ASM and create an object fORn rt 
Y« »u can enter other file specifications, if you want, to create the other type f fi| °* 
discussed in detail in Chapter^. 'Choosingand Using Your Assembler " Fori ** 
if you want to create a listing (1ST) lile and also a cross-reference (XRFl f I > ,nstancc ’ 
enter the following: ' * c * y°ucan 


/uxxxx 
/v,6, /wl, /w2 


TASM SUMS,.SUMS,SUMS 
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„., Ifnnv ln th ' 5 casc '« us « SUMS as the default name for the OBI 

have been used^ihe default 1 twei^g'thafnt) 1 fil^isoreatedh U * IS ^ l ^° S °*** CSwou ^* 

A, Ute^sXptZeT^tlSVnr’*" “ ‘ h ' h'*"*" 8 ° f ^ ^ 

TASM SUMS,,SUMS 

see a ^^I° U *? ter . thc command line and press Enter, TASM starts its work. You 
are returned th” , . Cat,n ® 1 at is assembled. If there are no errors, you 

Will be ,f '^ he >«“ “»» 

Turbo Assembler Version 3.0 Copyright (c) 1988, 1991 Borland International 

Assembling file: SUMS.ASM 

Error messages: None 

Warning messages: None 
Passes: i 

Remaining memory: 457k 

Turbo Assembler is done, and the file SUMS.OBJ should be in your sub¬ 
directory. 7 


If there were errors, you see a message indicating the type of error and where 
it was located. If you receive any error messages, you must correct the errors before 
continuing. Check your source file (SUMS.ASM) against the listing file (SUMS.LST) 
correct any errors, and try the assembly process again. After you have corrected all 
the errors, you can proceed with this chapter. 


Assembler Options 

You can use several parameters (referred to as options or switches in the 
documentation) with TASM to alter the way the program functions. You enter these 
options directly from the command line. 

Remember the help screen that appeared when you entered only the TASM 
ST™-™ 1 al thc DOS Prompt? It listed the command-linc options you can use with 
ASM. The available command-line options arc listed in table 6.1 and detailed in the 
following sections. 
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Table 6.1. TASAt command-lit, e options. 



n 

/a 

yc 

IOname( B text) 
I E 
/H 

/I pathname 

IJname 

IKHsize 

/L 

/LA 

/m passes 

/ml 

/MU 

/MVieogt/J 

/MX 

/N 

/0 

top 

IP 

/Q 

/R 

/S 

/T 


Display help information. 

Order segments in alphabetic sequence, 
include cross-references in the listing file. 

Define an identifier, optionally assigning text to name. 
Emulate floating-point instructions. 

Display help information. 

Search pathname for include files. 

Jam directive into effect. 

Set hash table capacity. 

Create a listing file. 

Create an expanded listing file. 

Set number of passes. 

Make case of names significant. 

Make all names uppercase 

Set maximum valid length for symbols. 

Make case of global symbols significant. 

Exclude tables from the listing file. 

Generate overlay code. 

Generate overlay code with Phar-Lap-style fixups. 
Check purity of 286/386 code. 

Suppress OBI records not needed for linking. 

Create code for numeric coprocessors. 

Order segments by occurrence in source code. 
Suppress assembly completion messages. 


Inversion 

/we 

/wi 

/W2 

/w- xxx 

lti*XXX 

IX 

U 


Set assembler emulation version. 
Suppress all warning messages. 
Enable all warning messages. 
Enable all warning messages. 
Disable warning class xxx. 
Enable warning class xxx. 

List false conditional statements. 
Display source lines with errors. 
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/ 4U 

/ZI 
/Z N 




Add full debugging data to OBJ file. 
Add no debugging data to OBJ file. 


that vni?^ t * Ul !? any of the command-line options listed in table 6.1 have variables 

ODiion Ra „™° C ° ° ns or s P“ es berwcen the option and the variable for the 
option. Rather, the variable immediately follows the option. 

Let s look at each TASM option in greater detail. 


Display Help Information (/? or /H) 

If you are using TASM and you forget what the syntax or command-line options 
are, this option displays the quick help screen (you saw this screen earlier in the 
chapter, when you entered TASM with no parameters) 


Alphabetic Segment Ordering (/A) 

This option controls the way the assembler writes segments into the object 
(OBJ) file. Ordinarily, the assembler writes segments in the order in which they 
occur in the source file. Some linkers, however, expea segments to be arranged 

alphabetically. If you are using such a linker, you should use this command-fine 
option. 


Include Cross-References 
in the Listing File (/C) 


If you have directed TASM lo create a luting file, thu option will create a 

SUiS^TV" *?* Ustin8 We For insance - in Chapter 3. if the listing file for 

aDDM H f a inc udcd a cross-reference, the symbol-table page would have 
appeared as follows: 
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Turbo Assembler Version 3.0 
Symbol Table 


12/18/91 17:39:44 Pa Q e 2 


Symbol Name 

770ATE 

7?F RENAME 

77TIME 

77VERSI0N 

032BIT 

BCODE 

PC0DES1ZE 

BCPU 

BCURSEG 

BOAT A 

boatasize 

BF RENAME 
BINTERFACE 
BMOOEL 
BSTACK 

bwordsize 

51 

52 

53 
SUM 
SUMS 
VALUE 

Groups 4 Segments 

DGROUP 

_DATA 

_TEXT 


Type 

value 


Cref 

(defined at #) 

Text 

*12/18/91 * 




Text 

•sums 




Text 

•17:39:44* 




Number 

0300 




Text 

0 


#17 


Text 

_TEXT 


#17 

#17 #18 




#17 


Text 

0 




Text 

0101 H 

• 



Text 

_TEXT 


. #18 


Text 

OGROUP 


#17 


Text 

0 


#17 


Text 

SUMS 




Text 

4H 


#17 


Text 

2 


#17 


Text 

DGROUP 


#17 


Text 

2 


#18 


Near 

_TEXT:000B 


#26 

20 

Near- 

_TEXT:0014 


27 

#30 

Near 

TEXT:0017 


25 

29 #31 

Number 

[DGROUP:BP+0006) 


#20 


Near 

_TEXT:0000 


15 

#20 * 

Number 

(DGROUP:BP+0004) 


#20 

24 

Bit Size Align Combine 

Class 

Cref (defined at #) 

Group 



#17 

17 

16 0000 Word Public 

DATA 

#17 

. 

16 001B Word Public 

CODE 

#17 

17 #18 18 


Define an Identifier (/ Dnamef=text ]) 

If you use conditional assembly directives in vour program, this option can 
come in handy. It allows you to define an identifier when you use ML. Thus, >ou can 
assign a specific value to a label that controls how the program will be assembled. 
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meaning only when ilw V >OUf propram ,nclu dcs w>me special code chat has 

conditional, being included^nr™ »T. t,cbu W ic<l - ,f ,hesc instructions arc 

the option /DcJebug=yes will causeTh 0 " ^ K, ™ Uficr debu ° is sct 10 V es - including 
y yes win cause the code to be included. 

you Uo°ih,X .'he'‘libel wm S C« equal loa'' “ Sig " Cd “ ** lal * 1 “ 

Emulate Floating-Point Instructions (/E) 

n«aUM.L7„.Ti^ r ,he °?T i,C 0f ,ht option > direc <» TASM to emulate the 
does no, ™ pa . bllmes **•* 808? - 80287.8038’. nr 8(M86 chips. The assembler 

code is linked a and hC “T' *- n ’“ lat,on routines; they are included when the object 
one is linked and a math-emulation library is used. Your high-level language may 

source ' ****“ lhls ^pc because such libraries generally come from a third-party 

codc 'l“t results from use of the it option can be executed on anv 
compatible computer, regardless of whether you have an numeric coprocessor. ' 

Override Default Include-File Path 

( [/Ipathname ) 

This option tells .ML where to search for include files in the source file (These 
files are pulled in during assembly through use of the include directive.) 

If your include files are spread among several directories, you can use multiole 
options to specify different directories. Each directory is searched in turn until die 
necessaiy include file is located. If. after searching each directory, the required 
include file is not found, an error is generated. ^ 


Jam Directive into Effect ( J]name ) 

comm 1 ?". < ,. P ' i T pim !,ny dcMrtd Turl, ° Assembler directive into effect from the 
ommand fine. Its major use is to wStablish processing modes. 
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Set Hash Table Capacity (jKHsize) 

This option sets the —- 

Without .his option, Turbo ^ hivc , m ublc fining everything .mo 

•£*££- reduce the amount of space needed. 

Create a Listing File </« 

™rrr irsrp•«.—-~—-- - * 

extension. (This file is detailed in Chapter 3 ) 

Create an Expanded Listing File (/LA) 

hu, 

directive and high-level-language support features. 

Set Number of Passes (/M passes) 

^utTu^’Sonaf assembly or conditional ermr directives that re. y on there 
being at least two passes. 

Make Case of Names Significant (/ML) 

Normally. TASM neats all ‘^^^gu^es^^o 

identifiers. 
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Make All Names Uppercase (/MU) 

The default setting for TASM, this option causes all names, labels, and symbols 
to be converted to uppercase. 


Set Maximum Valid Length for Symbols 
(/MV length) 

Some high-level languages limit the number of significant characters in 
procedure names or variables. This option tells TASM to set a limit on how many 
characters are significant. Valid lengths are anywhere from 1 to 255 characters. With 
this option set, TASM disregards anything longer than the maximum you set. 


Make Case of Global Symbols Significant 
(/MX) 

This modified version of the /ML option results in special treatment of only 
those identifiers that are seen by other programs. An identifier private to a particular 
procedure is still converted to uppercase. 

This option should cause your routines to work with most high-level 
languages. 


Exclude Tables from the Listing File (/N) 

Nor mally , the assembler includes (at the end of an assembly ' -ting LST file) 
several tables that recap the source file’s structure. You can use /N to exclude those 
tables without changing the rest of the listing. Using /N causes the assembler to 
function slightly faster. 


Generate Overlay Code (/O) 

This command-line option causes the assembler to generate fixups that will 
work with overlays. These fixups are then resolved by the linker so that your pro¬ 
gram can use overlays correctly. If you use this option, you should not . use any 
directives in your source code that instruct the assembler to use 32-bit addresses. 
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Generate Overlay Code with 
Phar-Lap-Style Fixups (/OP) 

This option is similar to the 10 option, except that a different type of fixup is 
generated. Because these fixups work with the Phar Lap linker only f you will not be 
able to use TUNK to link your program if you use this option. 


Check Purity of 286/386 Code (/P) 

Turbo Assembler can create protected-mode coding for the 80286, 80386, or 
80486 microprocessors if the proper assembler directives are present in the source 
file. The IP option specifies that the assembler should check whether the source 
code is “pure” (that it contains no data accessed in the code segment with a CS: 
override). If you use this option, an additional check is done and an additional error 
code may be generated. 

Suppress OBJ Records Not Needed 
for Linking (/Q) 

Normally, information that is not technically necessary for linking is included 
in the OBJ file for* legal or other reasons. Using this option causes Turbo Assembler 
to exclude the typical copyright information written into the OBJ file, as well as any 
file-dependency records. Because these records are used by programs such as MAKE, 
vou shouldn’t use the /Q option if you use MAKE. If you do, MAKE will not work 
properly. 


Create Code for Numeric 
Coprocessors (/R) 

Using this option causes the assembler to generate coding compatible with the 
numeric capabilities of the 8087,80287,80387, or 80486 chips. This generation of 
code affects only floating-point operations. Code created with the /R option can run 
only on computers that use one of these chips. 
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Order Segments by Occurrence 
in Source Code (/S) 

This option, which is the opposite of /A, is the default option. It specifies that 
segments be written in the order they occur in the source code. 


Suppress Assembly Completion 
Messages (/T) 

The /T (for terse ) option suppresses all assembler messages if the assembly is 
successful. If at least one error occurs, the normal assembler copyright and version 
information is displayed before the error is listed. 

r 

Set Assembler Emulation 
Version (/U version) 

This option is equivalent to using the VERSION directive in your source-code file. 
It allows you to specify which version of MASM or TASM should be emulated while 
Turbo Assembler is doing its work. The version may be one of the following: 

Assembler Version 


MASM 4.0 

M400 

MASM 5.0 

M500 

MASM 5.1 

M510 

Quick Assembler 

M520 

TASM 1.0 

i 

O 

o 

TASM 1.01 

TiOl 

TASM 2.0 

T200 

TASM 2.5 

T250 

TASM 3 0 

T300 
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Control Warning Messages (fW, /WO, /Wl, 
/W2, fW-xxx, and /W+xo;) 

Turbo Assembler gives you full control over the number and type of warning 
messages you receive when problems are found during assembly. This control is 
implemented with different variations of the /w option. 

You can turn off warning messages with the /W0 option, whereas both /Wl and 
/W2 enable their display. Turbo Assembler also classifies messages into groups and 
uses /w- 'nd /w*, followed by a three-letter class code, to individually disable or 
enable each group. By default, all serious and most advisory warnings are enabled. 
The warning classes arc 


Class 

Meaning 

ALN 

Segment alignment 

ASS 

Assume segment is 16-bit • 

BRK 

Brackets needed 

ICG 

Inefficient code \ 

LCO 

Location counter overflow 

OPI 

Unterminated (open) IF condition \ 

OPP 

Unclosed (open) procedure 

OPS 

Unclosed (open) segment 

OVF 

Arithmetic overflow 

PDC 

Pass-dependent coding 

PQK 

Assumes constant for warning 

PRO 

Incorrect protected-mode memory write 

RES 

Reserved word infraction 

TPI 

Illegal Turbo Pascal operation 


List False Conditional Statements (/X) • 

If you request a listing file, and your source file includes conditional assembly 
directives, this option controls the listing of the code not normally included in the 
LST file. If code were omitted from the OBJ file because the conditional assembly 
directives controlling that code's inclusion were FALSE, that code not mally would 
be excluded also from the assembly listing file. Using the / X option, however, enables 
such source code lines to be included in the listing even though no machine 
language code is generated. 
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Display Source Lines with Errors (/Z) 

message and the inc * ,catcs assembly errors by displaying an error 

To disp,ay r - 

Include Line Numbers in Object File (/ZD) 

suhvnl^nr w °^ ki " 8 a lar 8« program and running out of memory when you 

C ° deViCW ° r Turb ° Debu88er * *is option may help.it limits the 

memorl^? CbU ? Cr * SPCCif,t ,nformation storcd in thc OBJ file. Thus, you need less 
memory later when you use a high-level debugger. 


Add Full Debugging Data to OBJ File (/ZI) 

This option causes line-number information and symbolic data about all labels 
and variable names to be included in the OBJ file. This provides full operation of the 
symbolic debuggers (such as CodeView or Turbo Debugger), including evaluation 
of values at run-time and replacement with new values. 


Add No Debugging Data to OBJ File (/ZN) 

This option is the opposite of the /ZI option. If you use it, no debugging 
information is written to thc OBJ file. Although your code will be smaller, it will not 
work as folly with symbolic debuggers such as CodeView and Turbo Debugger. (You 
will not be able to take foil advantage of all of the debugger’s features.) 


Using TASM through a Batch File 

To make the assembly process easier, you can set up a batch file (as you can with 
many other development commands and programs). To do so, you must first 
determine which command-line options you want to use as a matter of course when 
you assemble your files. 

lowing batch file (ASM.BAT) is one I routinely use to assemble with the 
iAbM command line: 
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ECHO OFF 
CLS 


•.LOOP 

REM - CHECK IF NO FILES AVAILABLE ON COMMAND LINE 
IF SI/ ■« / GOTO OONE 

REM - CHECK IF EXTENSION (.ASM) WAS ENTERED 
IF NOT EXIST SI GOTO CHKEXT 

ECHO Could not assemble %l •• it contained an extension 
GOTO NEXT 

:CHKEXT 

REM - CHECK FOR ROOT PLUS ASSUMED EXTENSION 
IF NOT EXIST SI.ASM GOTO NOTFOUND 
ECHO Assembling ... SI.ASM 
TASM 1C /ML SI,,S1 >NUL 
IF ERRORLEVEL 1 GOTO ERROR 
GOTO NEXT 

:NOT-FOUND 

REM • FILE NOT LOCATED 

ECHO File SI Not Located or Found in Current Directory I 
GOTO NEXT 

:ERROR 

ECHO Error detected while assembling SI 

e 

:NEXT 

REM • CONTINUE WITH NEXT FILE - END OF LOOP 

SHIFT 

GOTO LOOP 

:DONE 

ECHO All Files have been Assembled t 

In this Ale, the assumption is that you will enter the command line as 
ASM filet file2 file3 ... 

where filet, file2, files, and so on are the names of the source-code Ales to be 
assembled. If ASM.BAT can be located in the current seafch path, you can use it from 
any subdirectory. The source-code Ale should be in the current directory, however, 
and the OBJ Ale will remain in the current directory. 
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IO BU y ° ur "«£ thCr COmnUnd - ,ine °PUO"s routinely, you can change the batch lile 


Meanwhile, Back at the 

Program... 

line options* it ” *” 7° u ” uld lea ™ >bout all the TASM ^- d 

assembled SUMS.ASM eariier in dUachTptTy^ did^ edand 

Remember that SUMS A.ev, ■ a ' So back and do so now. 

a moment to enter the following pro^fm^ l ° ** CaMed fr ° m aC+ + Program. Take 
c name of this program is TEST.CPP After cmeri >U S,mpIy doin 8 some testing 
C+ + com P^cr to compile i< to an OBJ^e 8 ^ usc ^ Borland 


/* Pile: 

* Author 

• Date: 


TEST.CPP 
Allen L. Wyatt 
10/15/91 


^Purpose: Program to test the calling of sums<) 


•include <iostream.h> 


•xtern 'C* {short sums(unsigned 
short status(unsigned short); 


short);) ' 


void main() 

{ 

. unsigned short i, x: 

j . ^ S 9 9 


*hiia (} 1*999) 

{ cout « 'initial Value: •; 
cin » j; 

if (J1=999) 

t x*status(j); 
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Pan 


7 Thelundamentals of Assembly Unguay 


for 0-1. x-l; xl*®; x«statu»(J**)) 


> 

short status(unsigned short orig) 

{ 

unsigned short result! 
result ■ suiBS(orig); 
if (orig>® IA result®*®) 

cout « 'Sorry, the sum has exceeded capacity ( 

cout « orig « * rows is too many)\n'; 

•Tout « -Th. sue Of • « oria « • rows i» • 
cout « result « *\n*; 


> 


return result; 

int :^ v 'r^ u Tun t JT"T«r e to it ,*» ^ ^ *- 

“**"£ , h , r .„ , h a, this limit is reached when the derived value is greater than 
<s“»5 When thta limit is exceeded, SUMS! ) returns aO and terminates execution 

the controlling C program. 

> 

Linking TEST.OBJ and SUMS ASM 

Unlike Microsoft's linking program. TUNK from Borland does not tore an 
interactive mode. All linking is done from the command line or from a response Ale 
Let’s look first at the command-line method. 

Using the TLINK Command Line 

Used from the command line, TUNK has the following general syntax: 

TLINK obj, exo, map, -U&. options 

where ob) is the name of the OBJ files, separated by spaces.«. is the 

final executable file, m, is die linker s listing file. J Mb die nam e of any U nary file., 

and options are the TUNK command-line options discussed in Chapter 4. 
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In the case of our oroDnm »u n _ 

follows. . P g ’ lhe corrcct command line for the linker is as 

TLINK cCs test sums,test,,cs 

two, but COS.OBJ may Y ° UShOU,d a,read > befamili a«'with 

C++to operate p r "~rlv T' * ,he stan ' u P needed for Borland 

In both files (COS and C cwi c ? C . LlB,s,h t elibrar ’ for,heB °rf>ndC++ functions, 
small memory model You 1 1Pd,ca,ts , ,ha ' yOU are CTea,in 8 a using the 

confirm this may Want ‘° look at *>*»« code for SUMS.ASM to 


Using the TLINK Response File 

olar,^ lythin8 ‘ hat C ? m ' S after the TllNK command at the DOS prompt can be 

h ™ S meth<Xi ° f USi " 8 TUNK iS bencflcial whe " V°n know 

repeatedly the same P r °8™> over and over again during development; 

peatedly typing answers to each question can be tiresome. 

To use this method of providing input to TUNK, create a normal ASCII text file 

with any name you want, that has the input for the command line. Putting each 

element of the command line (OBJ, EXE, MAP, UB, and options) on individual lines 

,S pa .™ ularly yi t se t ful For ‘nsunce, using the sample programs, the response file 
would have only four lines: 

c0s test sums 

.test 

nul 

cs 


TLINK uses this response file to link COS.OBJ, TEST.OBJ, and SUMS OBJ 
producing the default output file TEST.EXE. Notice the third line of the file, however 
The response here indicates that a map file is not wanted. Nul is the name of a 
standard DOS device—anything *ent out to the nul device is simply thrown away. 

To use a response file with TUNK, simply invoke TUNK using the following 
command syntax: * 

TLINK ifilename.ext 

filename.ext is the name of the response file TUNK is to use. Notice the 9 
symbol that directly precedes the file name. This symbol is the signal that TUNK 
needs to differentiate between a response file and a source file. 

»f the sample response file is named TEST.LNK, the following command wiU 
run TLINK and provide input to TLINK from the response file: 

TLINK 0TEST.LNK 
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The more you use TL1NK, the better you will understand the value of using 
response files. 


Testing the Finished TEST.EXE 

Now that your linker has created TEST.EXE, you can try your program tosee 
whether it works. To start execution of the program, enter the following at e 
prompt: 

TEST 

The result should be a prompt asking you for an initial value. Enter aninteger 
number, such as 7. You have just asked TEST to calculate the number of blocks i 
a seven-levefpyramid, such as the one shown in figure 6.2. 




The program dialog and results should look like this: 


C: \>TEST 

Initial Value: 7 

The sum of 7 rows is 28 


Ltial Value: 

n vnu cress return after entering the initial value, the response indicates 

there are 28 blocks in the pyramid (7+ 6+ 5+ 4+ 3 + 2 + 1 = 28). This 
is designed to continue asking for values and returning results until you 
ter a value of 999 Then the program generates a list showing both the initial and 
. . . es for pyramids between one row high and the maximum number of 

Z Xam cTZandlc. A pama. progmn, dialog follows: 
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C:\>TEST 

Initial Value: 7 

The sum of 7 rows is 

T "itial Value: 5 

The sum of 5 nows? is 15 

Initial Value: 22 

The sum of 22*rows is 253 

Initial Value: 103 

The sum of 103 rows is 5356 
Initial Value: 999 
The sum of 1 rows is 1 

The sum of 2 rows is 3 

The sum of 3 rows is 6 

The sum of 4 rows is 10 

The sum of 5 rows is 15 

The sum of 6 rowi is 21 

The sum of 7 rows is 28 

The sum of 8 rows is 36 

The sum of 9 rows is 45 

The sum of 10 rpws is 55 

(Intermediate values have been deleted to conserve space.) 

The sum of 353 rows is 62481 

The sum of 354 rows is 62835 

The sum of 355 rows is 63190 

The sum of 356 rows is 63546 

The sum of 357 rows is 63903 

The sum of 358 rows is 64261 

The sum of 359 rows is 64620 

The sum of 360 rows is 64980 

The sum of 361 rows is 65341 

sorry, the sum has exceeded capacity (362 rows is too many) 
C:\> 


* «-> N ° Uce th “ the upper ,lm “ the routine can handle Is a 361-row DV ramirt 
A 362-row pyramid contains 65,703 blocks, a number too Urge to be stored?* . 1 ?' 

unsigned integer used return value, from the assembly X^s^tine 
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Summary 


, ™ the 

^ling an assembler properly is essemlai .^ 

« -— wiU - the 
options only in specal situations. usem bly language progtams 

, rt The next chapter, you learn how to ucu B 

using DEBU^odeView. and Turbo Debugger. 
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Debugging Assembly 
Language Subroutines 



\YZ e aU lcnow what bu 8 s ***■ Thc banc of programmers everywhere, bugs seem 
W to crop up at the most inopportune times (such as when the program you are 
working on is supposed to be shipped out the door) and have been known to keep 
frustrated programmers from sleeping at night. The term debugging refers to 
removal of these pesky problems from your programs. 


Debugging as an Art Form 

If you have been programming for any length of time, you are already familiar 
with debugging tools for high-level languages. Anyone who has stared at program 
listings for hours on end knows that debugging software can make the job of 
debugging much faster and easier. 

Assembly language programmers can benefit from this software as much as 
high-level-language programmers. The type and amount of programming you do arc 
important factors in determining the type (and price) of the debugging tool you 
need. Hundreds of debugging tools, which run the gamut of features and prices, are 
available. 
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. •„ •„ ir^if make the task of finding and removing bugs 

that is the hard way, through experience. 

You may question my a'craftHowwer^here’* 

ming activity is u s much like comparing the detective exploit* 

3SKU5£2t2^^ _ 

Sometimes, of course, U takes the ''^y^^he^bug art WwUhtlMMMb 

to pin down a really subtle problem. More often the tfrtngs that Jon ’»happen reveal 
clues from the way the bug manifest itKlf ^ft^^Gc'mn^^^^ in Hound of the 

more than the things that do PP * niRht The debug artist then leaps 

ZEE XT- ~ * - or tna* of an 

uncommonly good guess. ^htioaine tools 

To learn the art of deb “ 88in ^’“o“ < Y^tefo^utm make tot choice, 
that fits the way you personaUy P« f ^ ^ this may seem to be a 

debugging! ^ ^ you can wisely select your Gist set of 

, 00 U.'£?fiS U t£ 0 a quick look a, the tools .ha, are available. 

The Two General Classes of Tools 

Software and debuffi«s(such ssDCTUg! 

of tracking andextcmunaungso^va ^ mory , e siden. and work fromwithin 

comlune a hardware computer card wid, 

softww to provide external debugging capabilities. 

Which group of debuggers is <’ <- "‘ rde ^ ds ^ " b '^^usmdlT GU*e bUl P Bu, 
if you are an apphcadons programme^ ^^^^^Jers who develop 
for system-level programmers as well as fo pp hardware debuggers can 

software designed to operate in real-time using intemip , on easily 

make life much easier. The types of glitches that crop up in such programs 
lock up a computer, rendering software debuggers useless. 
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Software Debuggers 

Highe^pri^d dtbu^e "uTuT fr ° m *“ ( ° EBUG) “ m °" *500. 

menfworthwhilc ForeMftm'u T°^ er fea,ures tha * ^ «** .hr invest- 

a few hours lost to mimuN t' '* > ’ OUr pro * rammin 8 llmc « worth *40 an hour, iust 
of a higheo^d commit U88,ng <USi " g 1 debu 88"> wou,d I"** •»* '<>« 

saved "S' pr ° grammcrs h « e ^ <•»< .he rim. 

° 8 a single bug more than offsets the cost of the debugger. 

operation of the»!f tWare debuf * era are wri “"> <° monitor (in a controlled way) the 
load the nroeran^hl j"?”" 1 Thes * d * bu 88 ers load themselves in RAM and then 
~cutrX m p , rc^l ebU8gedi ^ n< °—^^uggercancontro" 

*"•?" observ ers, software debuggers ignorantly foUow Instructions. If you 
«»mra the debugger toexecute a section of code, it will attempt todo so. sometimes 
estroying ttselftn the process. For example, if an errant program causes a sector to 
be loaded from disk into RAM at the place where the debugging software resides the 
e ugging session will come to a screeching halt, and the debugger will do nothing 
to stop the error. Totally isolating a software-only debugger is impossible. * 


Hardware Debuggers 

Hardware debuggers come in a variety of shapes, sixes, and capabilities. They 
typically consist of both hardware and software components. Usually the hardware 
component is either a card that fits in an ex,, ansion slot of the compmer, or a device 
that is placed between the microprocessor and the system board. The software 
component may be similar to the previously described software debuggers or it 
reside in ROM on the hardware board. ’ ^ 

Hardware debuggers, which are much more expensive than software debuggers 
can ran g e in price from *200 to almost *8,000. The prices vary according to thfrype 

wilUre'™* debUggCr ' ,he types ° p,ions addcd ' “ d the type of computer you 

The more expensive systems usually require a second computer to monitor the 

"wak ™ ese * ys,ems arc emulators or in-circn, 

ftototon systems such as these, you can come as close as possible to total system 

iusiih^hT" h SOd ] v ' lr , t d e bu 8Sers, the time saved in the development process may 
I ' h' , of a hardware debugger. Hardware debuggers are best suited for 
’" ° r mterrupt-driven software programs, which arc prone to bugs that 

c virtually impossible lo ferret out with software debuggers only. 
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r ■assrssn^saas^ 

than their software-omy f ,, a wa y for you to recover 

fo«e method of seizing control of the computer seldom fads to work. 

Some Software Debuggers 
Compared 

To help you ge, a feel for ^/^““^^.dt^aSe 

commands and general usage of language packages. Although 

5SSK--- wha, assembler and Unguage you choose. 

Built-In, High-Level Language Debuggers 

if vou are using any of the Quick languages, the Programmer s WorkBench 
!f you are using y , from Dortand, your language s Integrated 

from Microsoft or the Turbo languag and ' compll er combo normally 

^^^“o^no h- a^n debugging took This too. .recks each 
high-level language source statement so that you can inbrcb any variable you specify. 

Th,« debuggers are quite useful for finding problems in the high-level 
rnAe itself- they are much less useful for attempting to find problems in 
aasemWy language modules called from.he high-level language. The reason for this 
fsfoatfoese daggers make I. difficult or impossible to see wha. is going on in foe 
CPU registers while stepping Arough your assembly language modules, and Ae 
register contents provide many of the dues about what is going wrong. 

With Microsoft’s Quick languages, you can set watch variables with the register 
names and see those variables change; Borland’s Turbo languages, however, require 
that vou set the pseudovariables (_AX for AX, and so forth) in the watch window 
that you can see what is happening. Apparently, neither language can enable you 
view the result in the FLAGS register. 

The major use I have found for the built-in debuggers in this situation is to 

verify that the problem really is in the assembly language module and hc 

in the high-level program However, once the trouble has been isolated to the 
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anguage Subroutines 


totehlppen^he^' ror.hTs' '° "*$ '° * «" *ow you everything 

PP ng tneru. Tor .Ins, you need one of .he separa.e debugging u.ili.ies 


DEBUG, the Standard 


Only Jfew versions of ^ * ‘IT °’ ° EBUG °" > our DOS disk, 

moved over to the evr ° S ^ ‘ V 1 though the documentation for the program was 
he extra-cost Technical Reference Manual at version 3.3. 

exceD^n° This “f^° m >OU get f Whal you pay for " is often taie - DEBlIG is a notable 
Sow H r u program (free in the sense that most DOS usere don't even 

caoabUitv^r ° e P acka B* thC> pa> f ° r “ U comes at no extra cost) has most of the 

Seem L k ° S ° arC debu ^ er 11 ca " be ^ed for just about anything 
except tracing the operation of DOS itself; that requires a hardware debugger and 

a separate system connected to itl 

Once you know how to handle DEBUG, you can quickly learn just about any 
other software debugger. DEBUG’s only serious shortcoming is that it does not 
provide source-program display and tracking. 


DEBUG recognises two special file extensions, EXE and HEX, and treats files 
that have them differently from all others. The program loads any EXE file into 
memory just as the DOS loader would, using the file s relocation information to do 
the loading, and then discarding the information from the file. For this reason EXE 
files cannot be written back to disk; they’re not all there by the time you see the first 
DEBUG prompt. 


The other special file extension, HEX, is seldom used today except with 
embedded systems, although in the days of CP/M, HEX files were the standard output 
of assemblers. Files with the HEX extension undergo a conversion similar to that of 
EXE files, and, like EXE files, cannot be written back to disk from DEBUG. 


All other files are treated as memory images, like COM files, and are loaded at 
an offset of OlOOh; if you debug BIN files or device drivers, both of which begin at 
offset OOOOh, all assigned addresses will be OlOOh too high. 

DEBUG provides the 24 commands listed in table 7.1. The commands 
discussed in this chapter reflect the version of DEBUG distributed with DOS 5; your 
version may provide fewer commands. Normally, only about half these commands 
are used during a debugging session The most frequently used commands are 
indicated by an asterisk (*) after the command letter. 
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? 

Display help screen 

A* 

Assemble 

C 

Compare 

D* 

Dump 

E* 

Enter 

F 

Fill 

G* 

Go 

H* 

Hexadecimal arithmetic 

I 

Input 

L 

Load 

M 

Move 

* N 

Name 

O 

Output 

P* 

Proceed through operation 

Q* 

Quit 

R* 

Register 

S* 

Search 

T* 

Trace into operation 

U* 

Unassemble 

W 

Write 

XA 

Allocate expanded memory 

XD 

Deallocate expanded memory 

XM 

Map expanded memory 

xs , 

Expanded memory status 


To invoke any of these commands, enter the command character in either 
upper* or lowercase, and then enter any parameters that the command may require. 
In this chapter s examples of DEBUG commands, the command and any required 
parameters are shown in this typeface, with optional parameters in this one. 

DEBUG does not require any delimiters between commands and parameters, 
except when two hexadecimal numbers are entered as separate parameters. In * 
other instances, delimiters are optional, alrhough you may find that using t eo 
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Chapter 7; Debu gging Assembly Language Subroutines 

hexadecimal^Idfess. 00 del,n " ,er b " wcen *• «8™"t and ofti, of a 

change a line by pressinathe back'" y °“ press Entcr ’ no *»» you type them. Vou can 
type die coiTect ^ to McK wh « J« have typed and then 

to execute STeST COmnund “ ne b “ *“ —* '«• P™» Enter 

syntaxmrorbtan^ntnf df"” em>r * untU y°“ have pressed Enter. If you make a 
at the point at which the Bne ** re< h*played with the word error added 

oneeC^tL?e^,r, “ ,<a ^ *- “">ains mom than 

point. r ctectcd and indicated, and execution ceases at that 

this chapteTabout ‘,rt “ U 2. C ° mm “ d5 ( DI «ussiotts in later secdons of 

«* *• 


Display Help Screen (?) 


information that brilfl'y"recap^^ the^t^'for'DEBUG^ ProdU “ 5 a scceen 01 
command with the DOS 5 version of DEBUG produces the following:' 8 ^ 

A 


assemble 

compare 

dump 

enter 

fill 

OO 

hex 

input 

load 

move 

name 

output 

proceed 

quit 

register 

search 

trace 

unassemble 

write 


A [address] 

C range address 
0 [range] 

E address [list] 

F range list 

6 [-address] [addresses] 

H valuel value2 
X port 

L (address] [drive] [firstsector] [number] 
M range address 
N [pathname] [arglist] 

0 port byte 
F (-address] (number] 

Q 

* [register] 

S range list 
T (-address) [value] 

U (range) 

W (address] [drive] ffirstsector] [number] 


171 


Scanned by CamScanner 



allocate expanded memory 
deallocate expanded memory 
map expanded memory pages 
display expanded memory status 


XA (ffpages) 

XD [handle] 

XM [Lpage] (Ppage) [handle) 
XS 


Assemble (A) 

The Assemble command is used for entering assembly language mnemonics 
and for having them translated directly into machine language instructions in 
memory. This capability is extremely helpful for making on-the-fly changes to a 
program and for entering short test programs. The syntax for this command is 

A address 

address is an optional beginning address (hexadecimal) at which the as¬ 
sembled machine language instructions arc placed. If you do not specify an address, 
DEBUG starts placing the instructions either at CS:0100 or after the last machine 
language instruction entered through Assemble. 

Virtually every assembly language mnemonic, including segment override 
specifiers (CS:, DS:, ES:, SS:), is supported. There are one or two differences, 
however, between the standard mnemonics and DF.BUG’s implementation of them. 
First, because DEBUG cannot differentiate between NEAR and FAR returns, RET is 
assumed to be a near return, and RETF to be a far return. 

.Also, when a command line you enter refers to memory locations, DEBUG 
cannot always determine whether you want to act on a byte or on a word at that 
location. In the following example: 

DEO (4281 

it is not clear whether a byte or a word should be decremented at that location. To 
overcome this ambiguity, you must indicate explicitly which you intend. To do so, 
use BYTE PTR or WORD PTR, as in the following amended example: 

DEC BYTE PTR |42B) 

Clearly, such explicitness is not always necessary, as in this example: 

MOV AL,[42B) 

Because only a byte can be moved into al, using BYTE ptr here would be 

redundant. 

The Assemble command lets you use DB and DW (in addition to the regular 
8088 and 8087 assembly language mnemonics) to define data areas. 
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you warn v "he!? 1*"* f" ’'° U ^ Em " DEBUG canno1 de " rmi '' c «■* 
Lscmblc .ha, Hnc CCtU,n mncmonic ' « «»* 4* error and does no, 

to the De'bug d«h prom^. d US '" E Assemble comn '*>d. press Enter to return 


Compare (C) 

conrrm^f°^ Pare Comm I and com P arcs and sports on any differences between the 
contents of two memory blocks. The syntax for this command is 

C block 1 address 

an / ti l0 £l 1iS C ‘ ther h° th thc beginnin 8 and ending addresses or, if preceded by 
an /, the begi nning address and length of the first memory block, address is the start 

m !k C T C °T d T/ 110 / 7 block 1116 ,ength of the ^cond block is assumed to be equal 
o the length of the first. The memory blocks can overlap, and the second block can 
lie physically before the first. * . 

The command compares the two blocks, byte-by-byte, and reports any differ- 
cnees in the following format: 

addressl valuel value2 address2 


Dump (D) 

The Dump command is one you will use often. It displays the contents of a 
series of memory locations. The syntax for the command is 

D addrassl address2 

You must specify addrass 1 , an optional starting address for the display, before 
you can specify addrass2, an optional ending address. 

If no addresses are specified, DEBUG starts displaying memory locations with 
DSrOlOO or, if Dump already has been used, with the byte following the last byte 
displayed by the most recent Dump command. 

Dump always displays 16 bytes per line, beginning with the nearest paragraph 
(16-byte) boundary. This display rule may differ w ith the first and last lines displayed 
because you may have asked DEBUG to start thc dump with a memory location that 
^as not on a paragraph boundary. 
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If you do not specify an ending address, DEBUG always displays 128 bytes of 
memory. Each byte is shown in both hexadecimal and ASCII representation, as in the 
following example: 


0 2C5 

126F:02C0 0F 00 03-D1 52 57 36 FF 2E AC 04 -RW6- 

126F:0200 58 5F 07 8B DE BE 00 05*8B 0E 40 05 3D 53 59 74 X ••••••.0, — SYt 

126F:02E0 4F 3D 48 50 74 4A 3D 49-4E 74 45 BE 54 04 8B 0E 0=HPtJ=INtE.T... 

126F:O2F0 51 04 3D 42 4F 74 39 26-80 3D 00 74 16 26 80 70 Q.«B0t94.=.t.6.} 

126F:0300 01 3A 75 0F 26 8A 15 80-CA 20 80 EA 60 8A C2 FE :u.4. '••• 

126F:0310 C8 EB 06 B4 19 CD 21 32-D2 04 41 AA B8 3A 5C AB ...... 12. .A. •• \ • 

126F:0320 8C C0 8E D8 87 FE 84 47-CD 21 87 FE 73 12 EB 00 . G.I..S... 

126F:0330 83 F9 03 74 01 49 01 E9-73 01 A4 F3 AS 32 C0 AA .. .'t. 1..S...-2.. 

126F:0340 8B F3 36 FF 2E .. 6 .. 

Reading from left to right, notice that each line shows the address of the first 
byte, followed by eight bytes, a hyphen, and the remaining eight bytes of the 
paragraph. The rightmost characters on each line are the ASCII representation of the 
hexadecimal values in the paragraph. Note also that if a specific hexadecimal va ue 
has t o corresponding ASCII character, a period is used as a placeholder. 


Enter (E) 

To try temporary fixes during a session, you frequently need to use the Enter 
command. It enables you to change the contents of specific memory locations. The 
syntax for this command is 

E address changes 

address is the beginning address for entering changes, and changes is an 
optional list of the changes to be made. 

You can specify changes on the command line in any combination of hexadeci¬ 
mal numbers or ASCII characters. (ASCII characters must be enclosed in quotation 

marks.) 

If you do not specify changes on the command line. DEBUG enters a special 
entry mode in which the values of memory locations, beginning at address, are 
displayed. You can change these values one byte at a time. (Be sure to .nter the 
changes as hexadecimal numbers.) After each entry, press the space bar to effect the 
change. The next byte is then displayed so that you can make any necessary changes. 
To exit entry mode and return to DEBUG command mode, press Enter. 

If you enter a minus sign or hyphen as pan of a change to a byte, DEBUG goes 
back one byte to the preceding memory location. You can then make additional 
changes to that byte. 
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the next byte ThlTunrhfn an [ ' hlnge$ lo 3 •’)"*• P rcss the space bar to proceed to 
Dy “' T,M - unchanged byte retains iis original value. 


Fill (F) 

^ues U ^^7o7,tVl^r ,,Wro0,y Wi ' h 1 SP * CifiC V2 ' Ue ° f Stri “ ° f 

F block fill value 

l the^°rn , : eithe L b0th thC bcginning and cnd ' n 8 addresses or, if preceded by an 

fh" T W l reSS a , nd ,Cngth ° f 1116 memo ^ block - is the byte 

vafce(s) that should be used to fill the memory block. If fi j j.aiue represents fewer 

completed." neCdCd l ° “ ^ lhe ^ repeated untU Z blZZ 

ten rAnv khi T Y bC any comblnation of hexadecimal numbers or ASCII charac¬ 
ters. (Any ASCII characters must be enclosed in quotation marks.) 

the fo,lowing con *mand lines fills (with a hull value) 

the memory block DS:0000 through DS:OOFf: 

F DS:0009 09FF 0 
F DS:0090 LFF 0 

•a. u,. T ? 5 11 th ^ | same arca with hexadecimal equivalents of the ASCII characters 
ALW , followed by a carriage return and a line feed, you would use either of the 
following command lines: 

F DS:0990 00FF •ALWD A 
F DS.OOOO LFF m ALWD A 

Remember that the five values (41, 4C, 57, OD, and OA) are repeated again and 
again until all 256 bytes have been filled. 


Go (G) 

The Go command, which causes machine language statements to be executed 
« one of the most frequently used DEBUG commands. If you are debugging a 
Program, this command executes the program you have loaded. It also lets vou 
specify option breakpoints, which are addresses at which program execution will 
*op. The syntax for the Go command is 

G s start breakl break2 ... breaklO 
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•start is an optional Marring address, and "re**, through £.*>.** option^ 
breakpoint addresses. If the starring address is no. specified, Go beg.ns P V» 
execution with the current address contained in C5-.1F. 

u*.a -v/amtion continues until the program 
. If the breakpoints are not reached, exec assumed to be the 

ends. If you specify only an offset for a breakpomt address, CS .s assu 

To facilitate a breakpoint, DEBUG replaces the code reaches 

with the hexadecimal value CC, which is the co e h . or jgi na l values, 

the interrupt (the breakpoint), execution 

the registers are displayed (as though by the R command) ana P* 
stops If DEBUG never reaches the breakpoint, the values at the breakpoints 

in their changed state. 

t 


Hexadecimal Arithmetic (H) 

command. The syntax for this command is 
H valuel vdlu62 

value, and value* - hexadecimal 

, f . 

resulting in FFEFh: 

•H AE BF 
016D FFEF 

The second example performs the same operations with 96h and C2hi 

• H 96 C2 
0156 FFD4 


InP Thc LL command (the opposite of the Output command) fetches a byte 

from a port. The syntax is 


I port 
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from 'tile desircd'pon' intHhcnd' 'T 11,U ,npu * con >"«"><< fclclK* a byte 

doe, no, change any"^”^^ " " * ** 


Load (L) 

or dJSj inr::i^ c xcrL ,he wrac command) is u,td ,o ,oad a me 

L buffer drivenum startsec tor numsector 

i^aTo^io^num ati °HT!! ,0ry addrCSS rorthc infor ™ tion to be loaded, drivenum 
(a hexadecima| UmCr, | C d,!ik * dr ' w <lesi R na ‘or. startsector is rhe absolute disk sector 

numh^of r l ,t ‘ r) Wilh which *° wading, and numsector is the total 

number of disk sectors (a hexadec imal number) to read. 

drivenum. the drive specification, is such that 0=A. 1 = B. 2 = C, and so on In 
numsector. no more than 128 (8(ih) sectors can be loaded. 

HPm d ° ^ Pf ° Vide ,hc drivenum ""tsector numsector combination. 

DEBI G assumes that you want to load a file, in which case the buffer address is 

optional. If you do not specify an address. DF.BUG loads the file at CS:0100. Use the 
Name command -(described shortly) to specify the name of the file 

After a file has been loaded, BXCX contains the number of bytes successfully 
read, provided that the file does not have an EXE extension. If the file has an EXE 
extension. BX:CX is set to the size of the program. 


Move (M) 

The Move command moves a block of memory from one location to another 
The syntax is 

M block 1 address 

block 1 is either both the beginning and ending addresses or. if preceded by an/, the 
beginning address and length of the first memory block, address is the destination 
address for the move. The destination address and the source block can overlap. The 
bytes from the source block are moved, one at a time, to the destination address. 


Name (N) 

The Name command is used to specify’a file name to be used either by the Load 
and Write commands or by the program you are debugging. The syntax of this 
command is 
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N filename 1 filename2 

filename i is the complete file specification that is parsed and placed in a file control 
block at CS 005C filename2 is the complete file specification that is parsed and 
.placed in a file control block at CS:006C. 

In addition to parsing the file specifications. DEBUG places thcm ^ 
at CS0081. preceded by a byte indicating the number of bytes entered. DEBUG then 
sets AX to indicate the parsing status (validity) of the file specifications, with AL 
corresponding to the first file and AH to the second. Jf either file name is invalid, its 
corresponding byte is set to 1; otherwise, it is set to 0. 


Output (O) 

The Output command (the opposite of the input command) outputs a byte to 
. a specified port. The syntax is 

0 port value 

port is the address of the specified port, and value is the hexadecimal byte to write. 
This command does not change any registers or flags. 


Proceed (P) 

The Proceed command is available only with DEBUG programs distributed 
with DOS 3.0 or later versions. Using this command, you can execute machine 
language instructions in a single step, treating a CALLor an 1NT as a single instruction 
and performing the entire action with no pause, after which the register status is 
displayed (as with the Register command). The syntax of the Proceed command is 


P -start count 


Both r f these parameters are optional; =start is a starting address and count 
is t hexadecimal number that signifies how many individual instructions must be 
traced through to execute the command. If=start is not specified, execution begins 
with the current address contained in CS:IP. If count is excluded, only one machine 
language instruction is executed. 


The P command differs from T only in its handling of the CALL and 1NT 
instructions; P executes the entire called routine before pausing, whereas T executes 
only the iranstcr of control and then pauses at the first instruction of the called 

routine. 
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Quit (Q) 

., '* U ' Cd ,0 • ,ui, URUUG «<um control of the computer 

not mm *h Slm t > ' P rc!t * O'There are no parameters for this command, which doe» 

not Nave the programs on which you were working. 


Register (R) 

The Register command displays the microprocessor s register and flag values, 
and enables you to change individual register values. The command s syntax is 

R register 

register, the optional name of the register to modify, may be any of the following 
AX. BX, CX. DX, SP. BP. SI, DI. DS, ES, SS, CS, IP, PC, or F. IP and PC are synonymous; 
both refer to the instruction pointer register. F refers to the flags register. 

If you enter the Register command with no parameters, DEBUG responds by 
displaying a register summary similar to the following: 

• r 

AX=0®O0 BX s 0000 CX=00O0 DX=000O SP-FFEE „BP*0000 SI=0000 01=0000 
OS«1206 ES=1206 SS=1206 CS=1206 IP=010O NV UP El PL N2 NA P0 NC 
1206:0100 FB STI 

If you enter a register name as a parameter, DEBUG displays the current 
register value and waits for you to enter a new value. If you enter a value, it is assumed 
to be in hexadecimal. If you do not enter a value, no change is made to the register 
value. 

(For more information on the Register command, refer to this chapter’s "Using 
DEBUG'* section.) 


Search (S) 

With the Search command, you can search a block of memory for a specific 
sequence of values. The syntxx is 

S block searchvalue 

block is either both the beginning and ending addresses or. if preceded by an /. the 
beginning address and length of the first memory block, searchvalue is the byte 
value(s) you want to search for in the memory block. 
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The values (hat IJKBl IG searches for can he any combination of hexadecimal 
numbers and ASCII characters. (ASCII characters must be enclosed in quotation 

marks.) 

If DEBUG locates any exact matches, it displays the address of the beginning 
of the match. If no matches are found, no message is displayed. 


Trace (T) 


Using the Trace command, you can execute machine language instmctions in 
a single step, after which the register status is displayed (as with the Register 
command). The syntax of the Trace command is 

T =stert count 

Both of these parameters arc optional; *start is a starting address, and count 
is a hexadecimal number that signifies how many individual instructions must be 
traced through to execute the command If=starr is no, specified, execunonbegins 
with the current address contained in CS:IP. If count is excluded, only one machine 
language instruction will be executed. 

The T command differs from P only in its handling of the CALL and INT 
c.mns T executes onlv the transfer of control and then pauses at the first 
ZZZuoUZ cZl routine, bu, P executes the entire called routine before 

pausing. 


Unassemble (U) 

si- 

DEBUG operation. The syntax is as follows; 

U address range 

address, which is 0 P | i 0 ”^ , J*^^^^”^|^j*^^^.rtheendingaddressof^hearea 
orTpmccdcd by an /. the length of the area. If you specify an address bu. no rang., 
approximately one screenful of data is displayed. 

r aflf i res s or range, unasscmbly begins with the memory 

,f you do no,s P cc.fy anad^„sor^ b g^ a s ^ ^ ^ -h , hc bytc 

location indicated byCS, P£ (T U , Una5sc mblc command. The 

° f ins,rut,ion unt - s ,his proce5s 
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° f *>~ Usrd *» «* ~on | ini , „ you 
.vs and a range, all bytes within that block arc unassembled. 

TEST.EXE" seciiorv)^ 11 C ° mmand ,s ustd expensively in this chapter s “Debugging 


Write (W) 


or indMdwl diSS? COmmind) ‘ S US ' d ' OWriKa file 
W buffer drivenum startsector numsector 

b “'T ? ,he mem ° r y addre « of Ih ' infonnation .o be written; driven*, is an 
p nal numcnc diskdrive designator; starrseefor is the absolute disk sector (a 

of dlk seTlo«r^d whic * 1 ' wn,, ng is to begin; and numsector is the total number 
oi aisk sectors (a hexadecimal number) to be written. 

The drive specification, drivenum, is such that 0=A, 1 = B, 2=C. and so on. In 
numsector , the number of sectors loaded cannot exceed 128, or 80h 

nFm!r y ° U d ° Pf ° VidC thC drivenum ^tsector numsector combination, 
DEBUG assumes that you want to write a file; the buffer address is then optional If 

you do not specify an address, DEBUG assumes that the start of the file is CS 0100 
(Use the Name command to specify the name of the file.) 


Before a file is written, BX:CX must be set to the number of bytes to be written. 

As noted previously, two types of files cannot be written back to disk, those with 
an extension of EXE and those with an extension of HEX. The distinction is made 
solely on the file name’s extension; if necessary, you could use the N command to 
change the name and then write the file. However, the file that is written will be 
significantly different from the one that DEBUG read into memory. What is written 
will be a straight memory image. Thus, an EXE file will not be able to be properly 
loaded by DOS because it is no longer relocatable. Similarly, a HEX file is saved in 
ASCII text format by DEBUG. 


Allocate Expanded Memory (XA) 

This command was added beginning with DOS 5. If your system has expanded 
memory and an expanded-memory driver installed that conforms to the 4.0 LIM 
standard, this command allows you to allocate pages of expanded memory. 

The syntax for this command is 

XA pages 
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where pages is ihe number of EMS pages desired. Each page 

expanded memory. DEBUG displays an error message .f .he reques.ed memory 

not available or if you omit the pages parameter. 


Deallocate Expanded Memory (XD) 

This command was added beginning with DOS 5. Ifyour system has expanded 
memory and an expanded-memory driver installed that conforms to the 4. 
standard, this command allows you to deallocate pages of expanded memory. 

The syntax for this command is 

XD handle 

where handle is the EMS handle number for a specific block of EMS. If you previously 
used the XA command, this is the number returned when memory was allocated. 

Be careful not to inadvertently deallocate memory allocated toother programs 
that may be in memory. If you do, the results are unpredictable. 


Map Expanded Memory (XM) 

This command was added beginning with DOS 5. If your system has expanded 
memory and an expanded-memory driver installed that conforms to the 4.0 UM 
standard, this command allows you to specify a relationship berween logical and 
physical pages of expanded memory. The syntax for this command is 

XU’ logical physical handle 

The relationship between each parameter is as follows: logical page of 
expanded memory, using a specific handle, is mapped to the physical page you also 
specify. 

Expanded Memory Status (XS) 

This command was added beginning with DOS 5. Ifyour system has expanded 
memory and an expanded-memory driver installed that conforms to the 4.0 UM 
standard, this command allows you to view information about how expanded 
memory is being used in your system. 

There are no parameters for this command. When you enter it DEBUG 
responds with a list of F.MS handles and the number of pages allocated to each 
handle. Following that is a list of physical EMS pages and associated frahte segments 
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For instance, the following is a typical expanded-memory status display pres ided by 
this command: 

•xs 

Handle 0009 has 0024 pages allocated 
Handle 0001 has 0004 pages allocated 
Handle 0002 has 0080 pages allocated 
Handle 0003 has 0003 pages allocated 
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Phy , : *1 page 27 «= Frame segment 9C00 

Physical page 00 = Frame segment E000 

Physical page 01 = Frame segment E400 

Physical page 02 = Frame segmWt E800 

Physical page 03 * Frame segment EC00 

AB of a total EC EMS pages have been allocated 

4 of a total 40 EMS handles have been allocated 

Clearly, this is more than one screenful of information. Dtcatlse it scrolls by 
quickly, you may need to use Ctrl-S or the Pause key to halt the display temporarily. 


CodeView from Microsoft 

As you will see a bit later when you go through the debugging technique with 
TEST.EXE (created in Chapter 5). making effective use of DEBUG with programs 
generated by a high-level language requires some extra effort to get past the 
"invisible" stan-up code that all high-level languages include in their output 
programs. 

Because of this, source-level debuggers have become popular. One of the first 
of these utilities was Microsoft's CodeView. First distributed with the Microsoft C 
Compiler version 4.0, it is now packed with all the upper-echelon Microsoft 
language products. The version used for these examples came as part of the MASM 
6.0 package. 

Microsoft’s manual describes CodeView as “a powerful, window-oriented tool 
that enables you to track down logical errors in programs.” That’s an accurate 
description Like DEBUG, CodeView enables you to step through the execution of 
your program one operation at a time. Unlike DEBUG, it can also show you your 
source program in the language in which you wrote it, and perform entire statements 
without pause; yet when you need the single-step capability, that’s present also. 

You can use CodeView with any executable program, either COM or EXE. To 
take full advantage of the debugger’s capabilities, however, you must create an EXE 
file, using the special CodeView options during all steps of its creation, to get all the 
symbolic information from your source programs to a place where CodeView can 
use it. 

This means that your high-level language code and your assembly language 
modules should all be compiled or assembled, using the 7,i or ,Zd options, to put 
the information into the OBJ files. Then when you do the linking, you should use the 
/CO option to move this information to the EXE file. 
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Only when you do all this can CodeView 

by-line, and replace the hex mcmnrv n ' >u >oursourcc program, line- 

names of your variables. Because the ‘ ,hC reRisctT window the 

products, you will not be able to take full °P l,<>ns ^available only in Microsoft 

user. But as vou will oon see vou r W™** ° f Cod " Vitw * Turbo 

° 0n sec - y° u ^ not left out in the cold, either. 

CodeView s commands h OidtV S,mpl ff ^commands mainly follow the same syntax as 
The entries fc'* of command Nations. 
*hosc are ,hc majo “ nC es ^ " ' ht “■ 

For routine debugging, however, you need only a few of the a ailahle 

unHlt^DEBUG ^an^V yT* * SSCntial are listed in “Me 7.2. Notice that, 
uni U DEBUG, many of these -commands" are actually ‘hot-key- operations- tha 

all >ou do .s press the function kev. and the command execute^Yo^eed to press 
hnter only for the Q (quit) action. «u nceo to press 


Table 7 .2. ~bssential CodeView commands. """"’ 

Key 

Action 

FI 

Display on-line help screens 

F2 

Open Registers window (display registers) 

F5 

Go (same as DEBUG’s G) 

F8 

Trace (same as DEBUG’s T) 

F9 

Set breakpoint at cursor location 

F10 

Proceed (same as DEBUG’s P) 

P 

Proceed (same as DEBUG) 

Q 

Quit 

R 

Register (same as DEBUG) 

T 

Trace (same as DEBUG) 


When you call CodeView with a program file, as explained later in thisJ'hapter, 
CodeView automatically brings in the program’s source code if that code is available 
in the current directory. If the source code is not available, or the program file does 
not contain debugging information, the debugger automatically goes into “machine 
frnguage" mode, which provides a display much like that of DEBUG. 

You can move the screen cursor by using the arrow keys or a mouse. As you step 
through a program, using either F8 or F10, the highlight bar moves with you. When 
you get to the assembly language module, if you use l : 8 so that you do not step right 
over the module, the display changes i.) show the ASM source code. 
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That characteristic makes CodeView much simpler to use than DF.BUG. as you 
will see when you step through a session with DEBUG. If you have CodeV.ew 
available, you may choose to use DEBUG only when you cannot spare the memory 
that CodeView requires. 


Turbo Debugger from Borland 

Borland describes Turbo Debugger as a state-of-the-art source-level debugger 
designed for Turbo language programmers and those using other languages who 
want a more powerful debugging environment. Turbo Debugger does offer several 
features not present in the other programs discussed in this chapter. Among the 
most notable are its ability to take advantage of the 80386 chip’s capability to run 
multiple virtual machines, and its provisions for remote debugging. 

For the average DOS user, however. Turbo Debugger's major advantage is that 
it’s designed especiallyJor compatibility with the Turbo programming-language 
packages, and meshes with them more easily than CodeView. For example, the 
screen layout and menu choices arc similar to those found in the integrated 
development environments of Borland's Turbo and C+ + languages. 

Similarly, where possible the command and function keys serve the same 
purposes: F3 calls up the pick list, Alt-X exits, and so forth. The essential keys and 
commands needed for using Turbo Debugger are listed in table 7.3. As in all the 
Turbo environments, a context-sensitive reminder bar across the bottom of the 
screen shows you the most essential items at all times. 


Table 7.3. Essential commands for Turbo Debugger, 
k'w Action 


FI 

Display help screen 

Alt-Fl 

Display last help used 

12 

Set breakpoint at cursor 

1 + 

Trace (like DEBUG’s T) 

FH 

Proceed (like DEBUG’s P) 

F9 

Go (like DEBUG’s G) 

no 

Use top-of-screen menu 

Alt-X 

Quit to DOS 
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files, provided ,h;„ ,he program i 5 compiled 

appropriate options. These options are Iff. ' f , and l^ked with all the 
for CodeView, however. a^S!? nP ere ",‘ 1 °' TUft ” Debu S*» thl " “'ey are 
processed ihrough aTDCONVRTutilitveoThT °h Cod ' V ' ew dcbu Kging must be 
« no longer compatible wTh Codellw ^ ' hem "‘ he TO fot ™' «l>ey 

probably will chcrase^and sTick wkh^thw Cod v" 1 '^ *° ** * n “'° r factor You 
most unusual circumstances would you find *; odc ^‘f w or Turb ° Debugger. Only in 
the two debugger-data EXE-file formats. ^ to convcr t repealedly between 

The General Techniques 

infoJedd^ 

An example of a dehm.oino . • • , ? s DLSC l,ts y° ur °wn waysofworking. 

■SSSpSSSSSS 

aSS3~= 


Using DEBUG 

You should already have DLBUG because it is normally supplied with DOS 
This section describes the basicstif using DUDCCi and takes v( - S ' 


a sample debugging session. 


i ou step-by-step through 


Loading DEBUG by Itself 


debug 


Scanned by CamScanner 



188 


Pan I: The Fundamental?, ol <V»»emhly Language 


Aha YOU enter this cummami. a dash appears on screen at the left edge of the 
n.xt line This dash, which is DEBUG'S prompt character, tells you that DEBUG is 
awaiting your command. If you see any other message, chances are *“*““ *** 
misspelled DEBUG or that DEBUG.COM is not available on the current dtsk dn e. 

At the DEBUG prompt, type the letter R in either upper-or lowercase, and press 
Enter. The screen display should be similar to the.following: 


Odebug 

-r 

AX=0000 BX=0000 

OS 3 1206 ES=1206 

1206:010® FB 


CX=0000 DX=0000 SP=FFte 
SS=1206 CS«1206 IP=0100 

STI 


6P-0000 SI=0006 01*0000 
NV UP El PL NZ NA PO NC 


This entire display is the basic DEBUG “status line." (On your * crce ”’ 
numbers and letters on the line that starts with os» may be different from those 
shown here.) The R you entered is DEBUG'S Register command, which causes 
DEBUG to display the contents of the CPU registers. 

As you learned in Chapter 1, AX, BX, CX, and DX are general-purpose registers. 
Ordinarily they are the ones used for direct data manipulation. The other registers 
rsp BP SI D1 DS, ES, SS, CS. and IP) are specialized registers. When you start 
DEBUG, the registers AX, BX, CX, DX. BP, SI, and DI are all set to zero. 

The characters NV. UP El, PL, NZ, NA,' PO, and NC are the settings of each of 
the bits in the flags register. Table 7.4 shows the possible display values for each flag, 
deoendingon the flag setting. Note that in the Condition column, set denotes a value 
of 1 in the corresponding register bit, and clear denotes a value of 0. 

The current disassembled values of the code segment and the offset are 
disc laved in ^ bottom line. 1206. the value of the code segment (CS) register, is 
us«l as the segment; 0100 , the value of the instruction pointer (IP) register, is used 

as the offset. 

Vtlien you enter DEBUG without a file, the value shown for disassembly could 
he almost anything because you have not instructed DEBUG to initialize the memory 

in this instance, the byte at 1206-.0100 contains the value FBh, which is the 
numeric value for the mnemonic instruction STI. 

To end the DEBUG session and return to DOS. press0 (for Quit) and then press 


Enter. 


Now 


let's look at the other way to start DEBUG. 
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Status flag 

Condition 

Overflow 

Set 

- Clear 

Direction 

Set 

Clear 

Interrupt 

Set 


Clear 

Sifcn 

Set 

Clear 

Zero 

Set 

Clear 

Auxiliary carry 

Set 

Clear 

Parity 

Set 

Clear 

Carry 

Set 


Clear 


Meaning 

Display 

Yes 

OV 

No 

NV 

Decrement 

DN 

Increment 

UP 

Enabled 

El 

Disabled 

DI 

Negative 

NG 

Positive 

PL 

Yes 

ZR 

No 

NZ 

Yes 

AC 

No 

NA 

Even 

PE 

Odd 

PO 

Yes 

CY 

No 

NC 




Loading DEBUG with a File 


Sunni!* T CCW ‘ y '? be * in 3 DKBlG scssion is to 'P“ f '' file you want todebug 
,. PP°! C “ r example, that you want to debug a file called TEST.COM. To load 
debug and then IEST COM. enter the following line at the DOS prompt: 

DEBUG TEST.COM 


If DEBIT, cannot find the specified file, you see an error message, and DEBUG 

continues as though you had not entered a file name. Should this happen, you must 
do either of the following: you must 


0 Use the Q command to exit DEBUG and then, using the proper file specif., 
cation, sun over. (I prefer this option because it lets me verify the file 
specification.) 


□ Use the N command to correct the file name, followed by the L command 

to load the correct file. (These commands are described earlier in the 
chapter.) 
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, »*■. zzzstxsszzsss: ss* 

TESTCr>MncXo , drt^ ^P-Cifirarlon .. > f r» '"»*>‘ l 

DEBUG TEST.COM B: 

Aft(M . nFRUG has loaded TEST.COM. you see the dash prompt—DEBUG is 

After DEB . if vnu enter the Register command, the status 

2nd waiting for 2 cornniind* I» you K , • Dv.rY 

dispUy is similar to the K^ed'tom'the'lik'TEST.COMl^Sl^odter 

rc^teraand flagsshould be equivalent to the default settings DEBUG uses when no 

file has been loaded. 


Debugging TEST.EXE 


Now that you are familiar with starting and quitting DEBUG and with the 
DEBUG commands, lets see how DEBUG (unctions in a 

First you put a bug in the assembly language subroutine of the rLST.EXE P r °^a 
(developed in Chapter 5) so that there’s a reason for the search. Then, using DEBUG, 
you step through the faulty program to find out why it isn t working. 

The butt to be introduced is a common typing error: reversing the two register 
names in an ADC command. To create it. modify SUMS.ASM by changing the Une 
labeled Si . The modified listing follows: 

Page 60,132 

Comment | _....... 


File: 

Author: 

Date: 

Purpose: 


SUMS.ASM for Microsoft Macro Assembler 6.0 
Allen L. Wyatt 

8/3/91 

Given an integer number X, find the sum of 
X ♦ ( X * 1) ♦ (X- 2 ) ♦ (X-3) ♦ (X-4) ... ♦ 2 + 
Designed to be called from Microsoft C. 


Format: SUMS(X) 


PUBLIC sums 

.MODEL small, C 

.CODE 


Scanned by CamScanner 






sums PROC C Value: SWORD 
MOV AX,0 
MOV cx, value 
JCX2 S3 

S1: ADC CX.AX 

JC S2 
LOOP SI 
JMP S3 

S2: MOV AX,0 

S3: RET 

Sums ENDP 


Unitialize to zero 
I Get actual value 
;Num=o, no need to do 
iAdd row value 
;0uit if AX overflowed 
;Repeat process 
;Successful completion 
;Force a zero 
(Return to C 


END 


OfO. Fmm C , h hispofnt U on' T r ° U, ^ C r “ u,n m ans »« 

Put yoursdf in the place of a nr, y ° U n ° r kn ° VV " ,iat ,s tausin K this error, 
goodness hug in a program^ Pr ° Kr '’ n, '" 1 ' r ‘'Covered an hones, -.c 


Imk " rT° B) f,,rm 3 

inputs shown in Chapter 5. the foil,min* result's occur:’' 1 ' “* 


C: MAW>T£st 
Inirioi value: 7 

Sorry, the sum has exceeded capacity (7 rows is toe man-.) 
Initial Value: 5 

Sorry, the sum has exceeded capacity (5 rows is too many) 

. Initial Value: 22 

Sorry, the sum has exceeded capacity (22 rows is too man- > 
Initial Value: 103 ' 

Sorry, the sum has exceeded capacity (103 rows is too many) 
Initial Value: 999 

Sorry, the sum has exceeded capacity (1 rows is too many) 


C:\IIASM>_ 

This is not the intent of the program! Clearly, a problem exist.-.. Mur where in 
the program or routine is it occurring? \\ c need to start looking. Deducmely. we can 
determine that the Si .'MS routine, where the returned value always appears to be 0. 
,s a good place to begin the search. 


To begin using with TI.’ST HXI:. enter 

debug test.exe 


191 
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Register command (press R). 


DEBUG TEST.EXE 


AX-0000 BX-0000 CX-2163 OX-0000 
DS-0B14 ES-6B14 SS-0D5B CS-0B24 
0B24:00O4 B430 MOV AH,30 


SP-0800 BP-0000 SI=0060 01-0000 
1P-00C6 NV UP El PL NZ NA PO NC 


have been set properly, and the IP register is loaa 7 ff entry address is 

first program instruction to be cx “ u “ th 0 ^ f , odutcdby LINK.EX£ (refer 

t^Chapter' 5 !' Nmice also the valuesoffhe segment registers, particularly CS anti DS. 
(The values flavour segment registers may be different from dune shown.here 
depending on where in yourcomputers memory DEBUG has loaded the program.) 

Next, use the Unassemble command so that you can look at the first portions 

of program code: 


• u 

OB24:00C8 B430 
0B24.00CA C021 
0B2*4:00CC 3C02 
0B24: 00CE 7305 
0B24:00O0 33C0 
0824:0002 06 
0B24:00D3 50 
0824:0004 CB 
0B24:00D. r - BFA65A 
0824:000o 8B360200 
0B24:00DC 2BF7 
0B24: 00OE 81FE0010 
OB24:00E2 7203 
0B24:00E4 BE0010 
0B24.00E7 FA 
•U 

0624:0066 8E07 
0B24.0OEA 81C40E07 
0B24:00EE FB 
0B24:00EF 7310 
0624: 00F1 16 
0624:0OF ?. IF 


MOV 

AH,30 

INT 

21 

CMP 

AL,02 

( JNB 

0005 

xon 

AX,AX 

PUSH 

ES 

PUSH . 

AX 

RETF 


MOV 

DI.OCEA 

MOV 

SI,(0002) 

SUB 

SI ,01 

CMP 

SI,1000 

JB 

00E7 

MOV 

SI, 1000 

CLI 


Mpv 

SS,DI 

ADO 

SP.070E 

STI 


JNB 

0101 

PUSH 

SS 

POP 

ns 
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Chapter 7: Debugging Assembly Language Subroutine> 1Q^ 


0000 

0000 

0003 

0006 


0B24:00F3 E85A02 

CALL 

0350 

0B24:00F6 33C0 

X0P 

AX, AX 

0B24:00F8 50 

PUSH 

AX 

**24:00F9 E8EB04 

CALL 

05E7 

0B24:00FC B8FF4C 

MOV 

AX.4CFF 

0B24:00FF CD21 

I NT 

21 

0824:0101 8BC6 

MOV 

AX,SI 

0624:0103 B104 

MOV 

CL, 04 

0824:0105 D3E0 

SHL 

AX,CL 

0824:0107 48 

DEC 

AX 


This code is the assembly language translation of the machine language to 
which the C program (TEST.C) was convened. However, you have deduced that the 
bug probably is not in the C program; it is in the assembly language subroutine. How 
do you find it? 

One way to find the right subroutine is to use the Search command. But first 
you must determine what to search for. To do so, you need to look at the contents 
of the file TEST. LST (shown in Chapter 3) to see what the first several bytes of 
machine language should be. The appropriate code follows: 

.MODEL small, C 
.CODE 

sums PROC C Value:SWORD 

B8 0000 MOV AX,0 ;Initialize to zero 

8B 4E 04 MOV CX.Value ;Get actual value 

Notice that the first machine code bytes generated by the assembler were B8, 
00, 00, 8B, 4E, and 04. You will search for these six bytes—a combination unique 
enough to pinpoint the start of the SUMS subroutine. 

Using the Search command, search for these bytes from the beginning of the 
code segment. Be sure to search an area at least equal to the length of the file. 

When you enter 

-S CS:00 L2163 B8 00 00 8B 4E 04 
the computer responds 
0B24:00B3 

Sure enough, this series of bytes occurs at only one point in memory: at offset 
00B3h, the entry point for the SUMS subroutine. To view the code, use the 
Unassemble command. When you enter u B3, the following code is isp aye 
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•u b3 



0624:0083 B80O00 

MOV 

AX,0000 

0824:0066 8B4E04 

MOV 

CX,[BP+041 

0824:0089 E30B 

JCXZ 

0006 

0824:0008 13C8 

ADC 

CX,AX 

0824:0080 7204 

JB 

0003 

0824:00BF E2FA 

LOOP 

0088 

0824:0001 EB03 

JMP 

0006 

0824:0003 B80000 

MOV 

AX,0000 

9824:0006 50 

POP 

BP 

0B24:0OC7 03 

RET 


0824:0008 B430 

MOV 

AH, 30 

0B24:00CA 0021 

INT 

21 

0824:0000 3002 

CMP 

AL.02 

0824:00CE 7305 

JNB 

0005 

0824:0000 3300 

X0R 

AX, AX 

0824:0002 06 

PUSH 

ES' 


This code is the unassembled SUMS routine, beginning at offset 00B3h and 
continuing through offset 00C7h. It is not the entire routine, as the few bytes 
preceding offset 00B3h represent code generated automatically by the assembler to 
save information on the stack. But the important pan of the routine begins at 00B3h. 

Following this routine, a different one'Jbegins at offset 00C8h. (The routine at 
00 C 8 h happens to be the startup code for the C program, as Unassembled earlier.) 

As you probably have guessed, the search technique can quickly become 
tedious if you have not one but a dozen or so assembly language modules. Finding 
just the right one can take quite a while and divert your attention from the more 
essential task of finding the bug inside it. ' 

A quick way to get to the start of a specific assembly language routine is to go 
back and edit its source file, inserting the statement INT 3 as the first line after the 
PROC directive in the module to be located. Then reassemble and relink the file and 
bring it into DEBUG. Instead of searching for its first few bytes, however, just press 
G to let the program begin executing. 

INT 3 is referred to as the debugging interrupt, or breakpoint interrupt When 

the program gets to your int 3 operation, it automatically pops back to the DEBUG 
status line displaying the int 3 as the current operation. In the present case the 
screen would look like this: ’ 

9 

Initial Value: 5 

AX=0O02 BX=0EE2 
r»S=0CEO ES~0C£D 
0B27:00B3 CC 


CX-0019 PX-0000 SP-0FPC 
SS-0:£C CS=0B27 IP-0OB3 
INT 3 


RP=OEOC SI=0420 01=0420 

NV UP El PL NZ NA PE NC 
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_ haptc ‘ r 7: Debugging Assembly I 


anguage Subroutines 


/nstruction Pointer) command " ^ ^ routmv itse,f * usc ,ht * WP (Register 

•rip 
IP 0083 

by toHowing^he seirch^wtui a S breakpoint >mman<i “ ChieVeS ‘ h ' " mC **“* a,,ained 

to be. P 8rfm ' yo ^ »>«omMtcally have put a breakpoint exactly where it needs 

Because using the INT 3 instruction does require that you take the time to 
reassemble and relink your program, however, let’s use the search technique for this 

sample session. Remember that we found the one and only occurrence of the target 
stnng of bytes at location 00B3. get 

comn!!]’^ y ° U l Want t0 see what ha PP ens in th * routine, simply use the Go 
command to execute the program through the beginning of SUMS. Because the 

program runs normally until it reaches the breakpoint, you must'answer the 
value' 0 " y TEST EXE - for «« Proses. enter. 5 at the promprfor an initial 

•0 b3 

Initial Value: 5 


AX*0002 BX=0EE2 
DS*0CEA ES=0CEA 
0B24:00B3 B80000 


CX=0019 DX=0000 SP=0EOC 
SS s 0CEA CS=0B24 IP=0OB3 
MOV AX,0000 


BP-0EDC SI=0420 01=0420 

NV UP El PL NZ NA PE NC 


When DEBUG reaches the specified breakpoint of CS:00B3 (the CS is as* 
sumed), program execution stops and the register values are displayed. Now, using 
the Trace command to step through the routine, you can examine what is happening 
to the number being passed from C. 


AX=0000 BX=0EE2 CX=0019 DX=0O00 SP=0EDC 
OS=0CEA E$=0CEA SS=0CEA CS=0B24 IP=00B6 
0B24:00B6 8B4E04 MOV CX,[8P*04] 


BP=0EDC SI=0420 DI-0420 
NV UP El PL NZ NA PE NC 

SS :0EE0-0 


195 
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After each Trace command is entered. DEBUG executes the previously dis- 
plavecUns, ruction, which is shown on the unassembled status .me, and d,splays the 

registers again, as in the following code: 

« 

t 

AX=0000 6X=0EE2 CX=0005 DX=0000 SP=CE0C BP=0EDC SI =0420 01=0420 
OS=®CEA ES“0CEA SS=CCEA CS=«B24 IP-0089 NV UP El PL NZ NA PE NC 
0B24:00B9 E30B JCXZ 00C6 

In this display, the CX register has been loaded with the integer value (5) being 
passed from the controlling program. The next Trace instruction results yn execu¬ 
tion of the JCXZ 00C6 instruction, which bypasses the entire subroutine if the va ue 
being passed from C is a 0. Go ahead and Trace through the next step: 


AX=0000 BX=0EE2 CX=0005 DX=0000 SP=0EDC BP=0EDC SI=0420 01=0420 
DS=0CEA ES=CCEA SS=0CEA CS=0B24 IP=00BB NV UP El PL NZ NA PE NC 
0B24:00BB 13C8 ADC CX.AX 

The instruction to be executed next (ADC Cx.ax) is supposed to add the row 
value (5, which also represents the number of blocks on the row) to the value in AX 
(which is currently 0). But in the following display: 


AX=O000 BX=0EE2 
DS=0CEA ES=0CEA 
0B24 :00BD 7204 


CX=0005 DX=0000 SP=0EDC 

SS=0CEA CS=0B24 IP=00BD 
JB 00C3 


BP=0EDC SI=0420 DI=0420 

NV UP El PL NZ NA PE NC 


the value in AX did not change. The problem must be occurring here; the value is not 
being added to AX. As written, the program results in the sum of AX and CX being 
deposited in the wrong register, CX. 

To test this hypothesis, change the coding here by using the Assemble 
command to enter the following code at address CS:00BB: 

• a bb 

0824:00BB ADC AX,CX 
0B24:00BD 


Now the corrected coding is in place, but the instruction pointer register still 
points to the wrong location. You need to have the computer execute this newly 
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Chapter 7: Debugging Assembly Language Subroutines 


entered instruction. The following dialogue shows how’ to use tV Register com¬ 
mand to change the IP register and then use the command again to . iew the register 
contents: 

•rip 
IP 00BD 
:bb 
• r 

AX=0000 BX=0EE2 CX=0005 DX=0000 SP=0EDC BP=0EDC SI=0420 DI=0420 

DS=0CEA ES=0CEA SS=0CEA CS=0B24 IP=00BB NV UP El PL NZ NA PE NC 

0B24:00BB 11C8 ADC AX,CX 

RIP enabled the IP register to be changed to BB, the memory offset of the 
instructions just entered. Finally, the Register command causes DEBUG to display 
the registers so that you can verify that the computer is indeed ready to execute the 
proper instruction. Now you will trace through this step (ADC AX.CX) to verify its effect 
on the AX register. 

In the following display, the AX register has oeen updated to the correct value: 

•t 

AX=0005 BX=0EE2 CX=0005 DX=0000 SP=0EDC BP=0EDC SI=0420 DI=0420 

DS=0CEA ES=0C£A SS=0CEA CS=0B24 IP=00BD NV UP El PL NZ NA PE NC 

0B24:00BD 7205 JB 00B7 

Now, so that you can quit DEBUG, execute the rest of the program by using the 60 
command: 

•9 

The sum of 5 rows is 15 
Initial value: 3 
The sum of 3 rows is 6 
Initial Value: 7 
The sum of 7 rows is 28 
Initial Value: 999 
The sum of 1 rows is 1 

The sum of 2 rows is 3 

The sum of 3 rows is 6 

The sum of 4 rows is 10 

The sum of 5 rows is 15 

(Portion of output is deleted to save space.) 
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The sum of 358 rows is 64261 
The sum of 359 rows is 64620 
The sum of 360 rows is 64980 
The sum of 361 rows is 65341 

Sorry, the sum has exceeded capacity (362 rows is too many) 

Program terminated normally 

o_ 

Well, you’ve done it! You have just used DEBUG to track down a bug in a 
program. This example may be simple, but the precepts are the same regardless of 
the complexity of the problem Whatever the task, you must step through the coding 
to make sure that all is going as expected. 

By the way, DEBUG did not change the source or executable files. Now that you 
have discovered what the problem was, you need to change SUMS.ASM, reassemble, 
and then linn to produce a corrected version ofTEST.EXE. 


Using CodeView 

Now that you have seen how to locate the bug using DEBUG, let's look at how 
it's done with CodeView. The same bug will be used, but the OBJ files and the EXE 
file must be rebuilt to include the necessary debugging data. You can do this by 
following these steps. 

1. Reassemble SUMS.ASM as shown in Chapter 5, but include the /Zd option 
on the command line. 

2. Recompile TEST.C as before, but include the /Zd option on the command 
line. 

3. Relink TEST.OBJ and SUMS.OBJ as shown in Chapter 5, but include the 
/CO option on the command line. 

Afier completing these three steps, you are ready to use CodeView fullv with 
TEST.EXE. You can now invoke CodeView wiih the following command line: 

CV TEST.EXE 


Be sure that both TEST.C and SUMS.ASM are in ihe current directory so that 

CodeView can find them. The debugger will load, and the first screen wilMook like 
figure 7.1. 
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If you have usee: CodeView before, your screen may look a little different. You 
see. CodeView remembers how it was configured from Iasi time it was used, and 
starts using that same configuration. The important thing, however. isthatTEST.EXE 
is loaded, along with the source-code file, which is shown in the center source-code 
window. 

At this point the debugger is awaiting your instructions. What you see on¬ 
screen is not the machine code that DEBUG displays, but rather a portion ol the 
source File TEST.C. Notice also that you get no indication of what the CPU registers 
contain (refer to fig. 7. [). 

To see what is in the registers, you can enable the register-display window by 
pressing F2. When you do. the screen changes so that it looks like Figure 7.2. 

Now you can step through the program, one C statement at a time, by pressing 
FIO once for each line. I bis is the same as using the P command in DEBUG and hilly 
executes any lo.vcr-icvel function without pausing. When you get to the line 
containing the scant () function. CodeView switches iri*thc DOS screen and allows 
you to respond to the program's prompt Enter 5 as the initial value, anti press Enter. 
At this point, the CodeView screen should he tlispl.netl again. 

Continue pressing I 1(1 until the following (. source-code line is highlighted 
{ x=status(j); 
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Now. instead of us'ng l ; 10. use the FH function key so that CodeView traces into 
the status () function. Once in status(). you can continue to use F8 because it calls 
no lower-level function:; except your machine language routine, sums(), and that s 

the one voti want to examine. When vou reach line 15 of I FS IX. and press F8„the 

• * 

screen display changes to that shown in figure 7.3- 



rill 7.2. OxleYieu' C screen irilb register triiulow. 




Notice how much simpler it was to reach the assembly language routine with 
CodeView than with DEBUG. As you continue to.press F8, operation steps through 
the SUMS module: when control returns to status (). the display changes back to the 
C source code. 


You should have noticed, as with the earlier DI-BUG session, that the subrou¬ 
tine obviously contained an error. When you have determined that the instruction 
at label S1 .n figure y is at fault, use the F10 and F8 function keys to get back to that 
line (so that it is highlighted). I hen, use the A command as you would have in 
1)1-BUG. Press a and then press Enter. Now you can input assembly language code 
to correct the error, as shown in figure 7.4. 
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7.3• Cotit’V/cic M.-\SAJ s 



Help 

IHEnitfl 

fiK ■ OOl 

i:x i ori»i 
cx = 0019 
DX 1 0000 

sr - 

BP = OEDfa 
SI = 0120 
Dl = 0120 
OS = 2C21 
LS = 2C21 
SS = 2C2I 
CS = ZflSD 
IP = 

FL = 3202 

I'W UP El PL 
llZ MO PO HCl 


J m 


~ 7.4. After using tbe A commend and entering tbe assembly language correction. 



pbi 

Ik 7 -' 
(128: 

US: 

30: 

31: 

32: 


ttfTUiei" Scorch 1 Kdh>Uat ch 


lions CalltX -V' 

!|t|! 


sourrrj CS :\y suns.asn (ACIlOE) 


f SI 


S2: 
S3: 
suns 


rROC C Value:SUURl» 
ncru AX.O 
nou CX.Ualue 
JCXZ S3 

2^ 

JC 

LOOP SI 
JflP S3 

no KT 

RET 
EMDP 


nx,o 


:Initialize to zero 
;Gct actual u, .,. c 
:Mun=0, no need to do 

ggSSE3B BE5BM 

• Unit il fix ouerl Joucd 
Repeal process 
Success/ u ! conji let iuu 
Port v <i zero 
Return to C 


>a 

IEA5B.OOBB 

ltnSB:00BD 


adc ax.cx 


T 

f 


_ —» - - "-V i.ijijii I —III I 

*fc> <P18=Step> <F5=€o> <T6=Wlndov> 


<F3=Dlsplay> 


'*&*• Help 7 

SMBBHg 

AX = 0000 
BX = OCD-1 
CX = 0005 
DX = 0000 
SP = OECE 
BP - OECE 
SI = 0120 
Dl ? 0120 
DS ='2C21 
ES = 2C21 
SS = 2C21 
CS = 2A5F 
IP = 

FI. = 3202 

1U UP El PL 
ii: HA PU HC 


J 


20i 


Scanned by CamScanner 







.. ...wi<> window is not changed. That is 

Notice that the code in the center st * ^ h;lvc only changed the 

because you have not changed the sourc- CodeView. II you press F3. the 

assembly language instructions store in i * shown in figure 7.5. 

display in the center source-code window changes to_ 

Fig. 7.5. Mixed source code and assembly^ language instruct^fo -- 


Mit Ule* SeercK rjyVnTnTTrB' 


_ Mf •(.>. 'sv"■ 

!t 

ax - 0000 

BX = 0ED4 
CX * 0005 

dx * 0000 
bp * OECE 

;Qui t if OX overflowed SI = 0M 
; Repeat process g = 2CZ1 

:Successful completion SS = 2C21 
;Force a zero }[ ! 3202 


ADC CX.flX 


LU • 

2AS8:0OBB 7201 

vf \' LOT 

2aSB:00DF E2F0 
28: 

2ASB:00C1 EB03 
29: SZ: m 

2A5B:00C3 B80000 
30: S3: BE' 

^cn*nnrA qn 

SI 

>a 

2aSB: 00B8 adc ax.cx 
ZA5B:008D 

> __ 


nou ftx.o 
nou 

RET 

POP 


AX. 0000 


:Add row value 


;Repeat process 


:Force a zero 
:Return to C 




iu up ei rtl 
nz ma pn riel 




c enun r rode window. Immedately after this line 
Notice line 25 at the top of the ^ wil , exccuie . This line reflects 

is the real assembly anguages execute the changed line Now your 

the patch you made to the code. Press 

screen should resemble figure 7.6. 

has changed. Now you can press t-7. I » 

. , „ mu) , s tn initial value, and vour program completes 

cxecullonX^xleVi"'V JBJin ukcsconirol uiul displays the screen >luiwn in figure 7.7. 
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TRine Turbo Debugger 

S pyf file contain appropriate debugging 

• Turbo Debugger also that the EXE Me A «MV 

data but cannot use direct )t * , Vltvv files is included with the pac ag 

(TDCONVRT.EXE) forcomertmgt.o 

use it. first type 

™“"” T TEST.EXE -TEST EXE TD .,inked file. TDTEST.EXE. 

IO convert the CodeViCT.-l.nKed TEST CXE 
Then type 

10 1DTESI u f„r TDTEST EXE. The Erst screen displayed will look 

IO invoke Turbo Debugger for TDTEM.t 


something like figure 7.8. 


g 7.«. ffrsl screen i£Turbo Othugg^r 


. lle „ ■----« 
J-t.l^ie: test rile: teste 20 

11 return Cncu)» 

) 

mo id **in() 

► ( unsigned short j. 

UMIC Cj!=*W> 

( ,irintrc'tiut'At Udloe. 

SCO<'f t’*zu”.*j> ; 

if 

( )C = stAtllS( j) * 

) 

' *rl: wt-0; x-stdtustj*•)> 

for tj-»» * 


1-ltHU'l 




1Ltl . Nl „vvou are free... exit CtxleView 

press Enteracknowledge .he i»^ ^ ^ d() „ c nl „hing .« make 

is important to remember Hun ,o idem* the problem and 

permanent fix. Alter ustng the . l -< the fix into the source files, 

erify a fix that will work, you >«» *** 
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Notice that, unlike other source-level h.k 
a °" e *J ,nc help reference across the bottom of 1 JJ 88CrS * Turbo Dcbu gger shows you 
is the keyfor tracing into a routine and that F8 is ^ rem,nds > ou that F7 

rounne Without pausing (wha, 1 have called f °“ lepp,n 8 °'er » low-level 

Just like CodeView Tusbnn k ^ ,n ,he ott >« ^deseeiptions). 

source file when you trace into** ‘°** a P pro P ria " 

corrective actions once you have snottedrhe h d enablcs y° u to try various 

the result. The exact command?X ?^ h K Umin * Fi « ure 7 9 ^ows 
Debugger are essentiaUy equivalent to those iSr X h lhC capabi,itics of Turbo 
them are related more to th^ ?ene?i .* °/ C °^ f V,ew The differences between 
ordinary use. 8enend lo ° k and fccI tha « their capabilities for 



Fig. 7.9. Turbo Debugger ASM 


screen. 


F •; • 8 H 


lodule: suns rile: sun .asm 27- 
.HODEL snail. C 
.CODE 

1 PROC C Value:SUOKD 

nou rtx.e 

«0U CX,Value 


nou at 
Jcxz S3 

CLC 

adc at 
JC sz 
LOOP SI 
jrtp S3 

nou ax 

RET 

OOP 


cx, ax 
sz 


:Initialize to zero 
•Set actual value 
;fa»=e, no need to do 
*Initialize for start 
•Add ran value 
•Quit If AX overflowed 
•Repeat pro cess 


; repeat process E 

; Successf ul conplet lonpiu' 7 *’? 
;Force a zero pT&w 

••Return to C fcs&fT 


Summary 

In this chapter you learned the differences between software debuggers and 

hardware debuggers, and saw some of the characteristics of a few popular software 
debuggers. 


Scanned by CamScanner 


206 1: The Fu ndamentals of Assembly Language^ 


You learned alsowh^he MIWGxommandsare^d ho^tt^uscthem^ohelp 
—"rou can make ^ ^bugging ™ as 

efficient and productive as poss.ble. . _ need. You 

- Although DEBUG is helpful. “ ' ompuU so chat your only 

may discover errors that c 0 "'P e ' ely 0 P ff * e computer. In these Instances, 
alternative for regaining control o ^ ^assume that 

software debuggers such enter keyboard commands, 

you will always have some control, such as the ty 

Professionaldebuggersthatcombineh (0 moni tor and debug 

These debuggers provide a vunu y but m many development 

P ££Zcl "« Z only viable opdon for effective debugging. _ 

The ideal the operation 

operates without the debugger. 
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Using Additional Tools 


S assembl language programming 1 ^s^ertT' dCTe,0 P men ' “** for 

°«u° Zt^ToZlT y °T 

"umber of third parties. This rtapter an^thT * Microsoft ' Borl ^d, and a 
>™jcefil« and profilers are discussed L ^ cover a few of these tools: 
creating and maintaining libraries. C a P ler ’ w ^ erca5 Chapter 9 discusses 

Working with Makefiles 

bf c^u'ngBA^es'^tTn.™ "T *° "7** the —i—« of a project 
assemble and i u . ^ * nccessar X keystrokes to completely comoile 

that'* made up of Jdozcn 1h ^ d ° Whe ° y ° U an a PP ,icati °n 

andyou ^'a n ’° dU,eS - 

*e BAT file that recompiles and reassembles 
decade aco n P . f a ^ sy5tem dCT d°Pers came up with a better way over a 

**«. QuicW or rlT^mbtr “ ‘° Wh ° bUyS a “»* <* 

devtlopcd'r^ ‘ S 1 known ” MAKE - ^ the nm ' <* die first such program 
files but Jrh P ° f lhc UNDC systcm > In "“"y ^ys ir resembles the use of BAT 
contains are? 3 whcn you cxecutc a W flIc - almost all the commands it 

necessarv “ ccutcd —but when you run MAKE or one of its descendants, only the 
***y mmands get done; the rest are bypassed. 

207 
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—" i c n f As^cniblv 

Pan I: The rundamcwals ot --- 

*r\A which should be 

next subject. 


What Does MAKE Do? , hr 0 ugi. a 

adependenQ f.lenameisnotspec.fi • _ Becau5C most of these pans are 

optionM^h^vatious^brands'of ^^'^^^^^ev^riistof^escn^n'on^cc* 5 ' 

dependenQ files share one comm VP fc r<: ,a,ionship. Such a 

F.ch description block begins with a J ° ^ J umn c f the line and does 

rr.c— 

tessr ^ -rci - - - 

This relationship ‘‘^^“Ulels^a.et than that of the outfi.e, you 
infiles; ^ rebuilding the outfile. 

will have to correct of which starts with a blank 

The remaining lines °^^d comm(mf//inas* They specify exactly what.actions 
spaceoratabcharaQer^'^ted by the da.e-.ime companson. 
are to be performed , iWr , h e individual lines in a BAT file except that 

The command lines are exactly hkerne^ ines tta , ,he actions of this 

,he command lines are iindented ^l*nd lines are fed in strict sequence 

description block must t p« (hey hld been typed in from the keyboa 

>o thc COmpU,er ,USt ^differences between the available MAKE programs invohes 
One of the major dtfferc blocks are evaluated. Some of «hem 

the sequence in which t ^ sequence—the first block in the f.le is t ^ 
through the dependenQ performed, if necessary, before the secon» 

r ~ ~ 

by the final description description block in 

thc ,ine) ^ acti ° ns lhC 


Scanned by CamScanner 



t.ha picr 8: I sing Addiiion.il I I M lK 


i* similar to \\w ww blinker |U,Pt 1,11 Kk> M-aliau.il (this pr..,is» 

application lilc mus, * t nZ ***, * ''7’ nfc '- 1 " r TP-**- «* 

thi fits/ one described rather Hum die Iasi. 

among MAKE nmol- 0 lack of standardi/ation. rvaliutinn sequencing \uric* 

m™rr k 7K, S h A anS. kmT ^ """ " ^ ™ «« •«*- 


Microsoft’s Program-Maintenance Utility 

MASM 6.0 comes with a cops of N.MAKl-.EXE. the Microsoft program- 
maintenance utility. Although not representative of mainstream MAKE programs, 
this utility is described first because it is probably the simplest to comprehend. 

In its documentation. Microsoft refers to the dependency file foe NMAKE 
simply as a description file NMAKE enables one or more description blocks to be 
entered in the description file, and either a specific target file is evaluated, or the first 
file in the description file is evaluated (as a default). 

You can place comment lines anywhere you want in the description tile. 
Whenever the program encounters the # character—which indicates the start of a 
comment—all subsequent characters to the end of that line are ignored. Thus, 
comments may be added at the end of any line, embedded within a description 
block, or used for headers. 

A dependency line always marks the beginning of a description block in 
NMAKE. If you like, you can use empty’ lines to separate description blocks. The 
dependency line begins with the name of the output or target file, including its 
extension but without a path. This need not be an actual file name. For example, the 
pseudo-target ALL (or any other string you like) can be used if you want to force the 
command list to be executed every time this dependency fil| is processed. 

The target-file name is followed by a colon (:) and the inf tie list, a list of one 
or more file names (again, without a path). Either a comma or a blank space may be 
used to separate the names in the infile list 

When the dependency- line is evaluated, the date-time stamp maintained by 
DOS for each file in the infile list is compared to that of the target If any infile has 
a more recent time or date than that of the target, the command list is executed; if 
the target is more recent than any infile. the command list is skipped over and the 
next dependency block, if any, is evaluated. 

The command list consists of one or more DOS commands to be executed, just 
as in a conventional batch (DAT) file. To distinguish the command-list lines from the 
test of the dependency file's contents, however, each of the lines must begin with 
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at least one blank space or tab character. Most dependency blocks contain at least 
one line in their command list, although this is not mandatory. If no commands 
follow the dependency' line, a default mechanism called the Inference rule list takes 
over. If the dependency line fits any inference rule, the command list for that rule 
is executed. If not, nothing is executed (but no error is declared). 

The full syntax for an NMAKE dependency block is 

target : infile[[,} infile][* comment] 

[command |# comment ]] 

where the items shown within brackets arc optional. 


Inference Rules 

The inference-rule list consists of one or more rules that tell NMAKE which 
commands to execute when a dependency block contains no command list of its 
own. Each rule, like a dependency block, begins with a relationship statement, but 
instead of dealing with specific files by name, an inference rule applies to groups of 
files distinguished by their extensions. The syntax is 

(* comment) 

. inext.outext: 
command 
l command] 

Notice that in the inference rule, both the inext and the outext appear in the 
“urget” position, to the left of the colon, and nothing appears to the right of the 
colon. When j Mile is to be applied, the time relationships have already been 
determined; the purpose of this line in the rule list is to let NMAKE find the specific 
rule to apply. For instance, a typical inference-rule list for assembly language 
programs might be the following: 

0 default actions when assembly required, keep C00EVIEW info 
.ASM.OBJ: 

ML /C /Cx /Zi /FoSP /FI ,$•.asm 

I default linker actions 

.OBJ.EXE: 

LINK /MAP /CO 

The dependency line, test .obj : test, asm, with no associated command list, 
would match the first of these rules, executing the command ml /C /Cx /Zi 
/Fotest.obj /FI test. asm as a result of the match. A subsequent dependency line, 
test.**® • test.obj mine. obj (again, with no command list) would match the 
second rule and, as a result, execute link /map /co test.obj aine.obj .test.exe;. 
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Command Modifiers 

Dependency blocks and inference rules both enable you to specify commands 
to be executed by NMAKK. \ou can modify the way NMAKE executes commands 
through the use of command modifiers (see table 8.1). When command modifiers 
are prefixed to commands, NMAKE changes the way the prefixed commands are 
executed. 

Table 8. J. Command modifiers for Microsoft NMAKE. 

Modifier Meaning 

Disables error checking for command it modifies. If * is 
followed by a number, NMAKE halts only when exit code 
returned by command is greater than the specified number. 

Prevents NMAKE from displaying command as it executes; 
modifier's action is identical to that of similar modifier for 
BAT files in DOS version 3 3 and later versions. 

Causes command to be repeated for each listed file repre- ' 
sented by special macro if modified command uses one of the 
special macros S? or $••-. on each repetition, special macro is 
replaced by next file name in list. 

In all three exses. the command modifier must immediately precede the 
command to which it applies. 


9 


I 


Macro Definitions 

Those strange expressions (S*. $*V and S@) in the preceding inference-rule list 
are references to macro definitions built into NMAKE and defined in table 8.2. The 
program provides also for user-defined macros in its dependency files. 


Table 8.2. Built-in macros. 


Macro Meaning _ 

$$e Target currently being evaluated 


S(AFLAGS) 

*(AS) 

S(BC) 


Options to pass to Macro Assembler 

Command to invoke Macro Assembler; preset to ml 

Command to invoke BASIC compiler^ preset to be 


continues 
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Table D.2. continued 


Macro 

S(BFLAGS) 

$(CC) 

S(CFLAGS) 

S(C0BFLAG9) 
$(COBOL) 
S(FFLAGS) 
S(FOR) 

S (MAKE) 


S(MAKEDIR) 

$(MAKE FLAGS) 


S(PASCAL) 
$(PFLAGS) 
$(RC) 

S(RFIAGS) 


Me aning ___ _ _ 

Options to pass to BASIC compiler 

Command to invoke C compiler, preset to cl 

Options to pass to C compiler 

Options to pass to COBOL compiler 

Command to invoke COBOL compiler, preset to cobol 

Options to pass to FORTRAN compiler 

Command to invoke FORTRAN compiler, preset to f.l 

Name with which NMAKE was invoked, used to call 

program recursively; causes line In which it appears to 

be executed even if /N option is in effect 

Directory from which NMAKE was invoked 

List of NMAKE options currently in effect; cannot be 

redefined, but is used with S(MAK6) to pass current 

option list to recursive call—for example: $(UAKE) 

$(MAKEFLAGS) 

Command to invoke Pascal compiler; preset to pi 
Options to pass to Pascal compiler 
Command to invoke Microsoft Resource Compiler, 
preset to re 

Options to pass to Microsoft Resource Compiler 
Target name without extension 
Complete list of infilcs 

Name of infile that triggered execution of command list 
(evaluated only for inference rules) 

List of infilcs newer than target; useful for updating LIB 
files and executing similar actions 

Complete target name 


When NMAKE is processing any command list, whether from an inference rule 
or from a dependency block, these macros expand into the corresponding file 
reference as shown in the example (S(Make ) $(makeflagS)). The macro capability is 
not limited to file-name references, however. Macros arc commonly used also to 
modifv the options passed to the assembler, the linker, or the library manager. 
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1 he syntax for creating a user-defined 
level to SET an environment string: 


macro is similar to that used at the DOS 


(<v comment J 

name[ J»[ )(*)t«xt( a ] 


if ‘t n °res any blank space on either side of the equals sign (■) character. 

string that will replace the macro name when referenced contains any 
blank spaces or “special" characters, the string must be enclosed in quotation marks. 
Including the quotation marks never hurts and can prevent problems caused by 
special characters (that is, characters other than letters and numbers). 

To indicate where NMAKE should replace a macro with a text string, just 
reference the macro as follows: 

ifname) 


* This entire string is then replaced by the text associated with name. For example, 
if the command line for the LINK inference rule in the previous example had been 
LINK $(L0PT) S**,SP; instead of LINK /map /CO $••,$$;, and the macro definition 
LOPT-* /MAP /CO" had preceded the inference rule in the file, the results would have 
been the same Its those shown in the example. 

To remove the CodeView information from the output file, however, all you 
need to do is redtfine LOPT as / map and that, as you will sec shordy, can be done from 
the command line when NMAKE is invoked. Thus, the macro capability gives you an 
added dimension of freedom (and consequently a greater possibility for complica¬ 
tions) in the use of the file. 

You Am also refer to environment variables as if they were macro definitions 
in the file. For instance, to use the environment variable PATH as part of a Command 
line, you simply insert S(PATH) in that command line of the dependency file. If the 
file has a macro named PATH, it is used; if not, the content of the environment 
variable path is used. 


Be careful not to overuse the macro feature. Excessive use of macros is the 
major reason most sample dependency files supplied with the different language 
products are Incomprehensible at first glance. NMAKE Itself never requires such 
complexi ty. 


NMAKE Directives 

NMAKE enables you also to control the flow of actions in a dependency file by 
using directives. These directives, also called preprocessing directives, arc used in 
dependency files much as directives arc used in ihc assemblers themselves—as 
commands directed primarily toward controlling the NMAKE program's actions 


Scanned by CamScanner 



214 


Part I: Thy Fundamentals ot Assembly language 

rather than toward generating output. Using the NMAKE directives listed and 

l table H 3 you can change the commands «h.« are , “^anlo^lon 
the presence or absence of a defined macro name, or on the value of an ”P fe ” on - 
Directives also let you use inclutlc files, output an error message, or alter the settings 

of the option switches. 


Table 83. Directives for Microsoft NMAKE. 


Directive 


ICUDSW ITCHES: 


1ELSE 


sENDIF 


1ERR0H text 


I IF «xpr 


HFDEF macro 


Description 


This directive, which may be followed by a plus sign 
(♦) or.» minus sign (•), must then specify one of four 
option indicators: / D, / I, /N. or /S. If the plus sign (♦) 
is used, tnc named option is turned on; if the minus 
si^n (•) is used, the option is turned off; if neither 
one is used, the option is returned to the-condltion 
specified by the command line used to invoke this 
NMAKE This directive changes the MAKEFLAGS macro, 
which cannot be altered directly. 

Used only between ! IF and IENDIF statements. (ELSE 
indicates end of a statement list to be executed if I IF 
is true (nonzero), and beginning of a list to be 
executed if condition is false (zero). 

Marks end of an ! IF sequence. ! IF... tENDIF sequences 
can be nested because each l IF extends to its match* 
ing IENDIF. 

Causes message text to be printed, then halting 
execution of NMAKE. 

If value of expr is nonzero, statements in the file 
between this directive and next matchiag I ELSE or 
tENDIF are executed; otherwise, such a sequence of 
statements is not executed. If an !ELSE statement is 
the next matching directive, statements between it 
and the matching IEKOIF arc executed; otherwise no 
statements before the matching IENDIF are executed. 

Similar to the t IF directive, but instead of basing its 
decision on the value of an expression, l IFDEF 
executes subsequent statements only if macro has 
been defined, although the value of macro is immate¬ 
rial ielse and iendif statements are executed as they 
were with 1 IF. 
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Directive 

Description 

IIFNOEF macro 

Exactly like IIFDEF. but with reversed meaning; 
statements are executed if macro has not been 
defined. 

1 INCLUDE 

Followed by a file name, causes named file to be read 
and evaluated before continuing processing of 
current makefile. If file name is enclosed in angle 
brackets (< >), paths specified by an INCLUDE macro 
or ^n environment variablt are searched for the file; 
otherwise, only current directory is searched. 

IUNOEF macro 

Used to undefine macro, after execution of this 


directive, macro is no longer defined. 


Using the directives greatly complicates the design of a dependency file but 
docs make it possible to introduce powerful capabilities, based on choices specified 
by the presence or absence of only a few command-line-defined macros. Until you 
are completely comfortable with the simpler ways of dealing with dependency files, 
however, you arc better off avoiding these directives. 


Invoking NMAKE 

To use NMAKE, invoke it from the DOS prompt with the following syntax: 

NMAKE( options]] aacrodefs]] targets] [ filename] 

The options recognized by NMAKE are listed and described in table 8.4. You 
can use any noncontradictory options simultaneously. 


Table 8.4. Command-line options for Microsoft’s NMAKE. 


Option 

Meaning 

n 

Display quick help screen 

/A 

Force execution of all commands, regardless of date of 


{ last update 

/c 

Suppress nonfatal error or warning messages and the 
NMAKE copyright message 

IQ 

As file is processed, display date each file was last 
modified 


continues 
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Option Meaning 


/E 

Use environment variables instead of macro definitions 


in description file 

IF filename 

Specify description file to use instead of MAKEFILE 

/HELP 

Invoke expanded help system 

ll 

Ignore exit codes returned by command-line programs 

IH 

Display (but do not execute) commands that would 
otherwise be executed; useful for debugging 

1 NO 

Suppress NMAKE copyright message 

IP 

Display macros, inference rules, and target descriptions 
during processing 

/o 

Quick execution; checks update time of files and returns 
an error code if target file should be updated 

/R 

Ignore predefined macros and inference rules 

IS 

•‘Silent” mode; does not display command lines as they 
are executed 

11 

Execute preprocessing commands only, and change 
modification times for command-line targets 

/X filename 

Redirect all error output to filename 


Notice that when you invoke NMAKE, all the parameters on the command line 
are optional. If they arc all omitted, NMAKE looks (by default) for a file named 
MAKEFILE and processes it as the dependency file. In fact, unless the /F filename 
option is used to specify the dependency file's name as pan of the option list, 
MAKEFILE Is used if it exists. The file name passed by itself on the command line is 
used only if MAKEFILE cannot be found. 

You can define macros in the command line just as you would in a dependency 
file. Any definition given in the command line overrides internal definitions in the 
dependency file itself (which, in tum, override environment variables of the same 
name). Thus, to change the definition of the LOFT macro (in the previous example) 
so that no CodeView information is put into the EXE file (and assuming that the 
dependency file is named sample.mak), simply type 

NMAKE 10PT«*/MAP* sample.mak 

For a full example of the use of NMAKE, see the “Creating and Usings Makefile- 
section later in this chapter. 
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Borland’s Version of MAKE 

much like Turbo Asscmb'c operates very 

discuss only ,h«*e features in "“*** *“' "* 

The lomniand-lme syntax for the program is similar to NMAKE's. but shorter: 
MAKE( options]l targets] 

notomvidJ^ vcrs,ot \ tr ^ ats 3,1 file names on the command line as targets and does 

mtero ,tlr m definitions as a separate kind of command line parameter; the 

macro definitions are still there, but as options. 

T *]f °?" on *' st tor MAKE is much shoner than that for NMAKE. And MAKE 
U |? 1 r M,crosoft programs, treats as significant the case oi the option character: 

mac e tnes a macro named mac. but dmac is not recognized and results in a fatal 
error. Valid options and their meanings arc listed in table 8.5. 

Table 8. 5. Opt ions recognized by Borland s MAKE. — 


Option 


•D macro 

• Dmacro-string 


■ffilename 


■ Idirectory 


Meaning 

Causes MAKE to perform an autodepcndency check 
(unfortunately, neither the manuals nor the on-line 
help give any clue as to what this autodependency 
check might be!) 

Builds all targets regardless of file dates 
Defines a macro with no content 

Defines a macro containing a string; both -D options 
provide for command-line redefinition of macros 

Tells MAKE to use filename as its input dependency 
file; if filename cannot be found and does not contain 
an extension, MAKE then searches for filename.MAK 

Does not check exit status of all programs run 

Specifies the directory to be searched (in addition to 
the current directory) for files to be INCLUDEd 

Keeps temporary files created by MAKE 

Does not execute commands (same as Microsoft 
program’s /N option) 

Does not display command lines as they are executed 
(same as Microsoft program’s “silent’* mode) 


continues 
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Table 8.5 continued 
Option _ 


•U macro 
• ? of -h 

•W 


Me aning _ 

Twaps MAKE out of memory while executing 

commands 

Unde fines any existing definitions o( macro 

Provide* on-line help 
Writes the current specified nonstring options 


name for the dependency file to process. 

Also like NMAKE. if no target All other 

dependency block rncoun.cted o r ^ jn ^ jnflles ljst for that first 

decency'"rfo^me subsequent b.ock that was evaluated because its 

target was involved in the first block. 

The list of built-in macros for MAKE is much shorter than the corresponding 
J uble 8.6 lists and describes all of them. In addition to the seven 

macros listed in the table, all existing environment variables automatica y are 
loaded as macros. 


Table 8.6. Built-in macros for Borland"s MAKE 


Macro 


$d (macro) 


$• 

$< 


Meaning _ 

Expands to 1 if macro is defined, and to 0 if not; valid 
only when used in • if and lelif directives to achieve 
the same results as NMAKE’S IIFDEF and IIFNOEF 
directives 

Expands to the base name (including the path but 
without the extension) of the target file 
Expands to the full name (including path and exten¬ 
sion) of the target file when used in a dependency 
block, or to the base name plus source-file extension 
when used in an inference rule 


Expands to the path name (without the file name or 
extension) of the target file 
Expands to the file name (without the path but 
including extension) of the target file 
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J4AKE_ 


Expands to the base name only (without the path or 
extension) of target file 

Expands to 1 


B ° r ! lnds MAKE implements directives that serve the same 
described next. " “ emb,y lan 8 ua g* The seven directives for MAKE are 

ally mav 'foclud^f. begi " S an 1 lf • • • 1 sequence that option- 

«LZ‘" ! d , e a " d J*ls* directives. The directive must be followed by an 
ji . ^ usln ® any 0 ’i* c standard C operators), which may include the Sd() 
^hihi^i w P 7 S ? e ' alua, « IO a value, all statements up to the next 

ZoreH®- « 1' are executed; then statements are 

Ignored until the matching l.ndlf is reached. If the expression evaluates to aero 
statements up to the next matching lelir or lelse are ignored. 

. , a 7 he J * Uf directlve * uni< l uc lo Boland s .MAKE, performs another test similar 

to lif when previous tests have failed. Like lit. lelif is always followed by an 
expression. If lelif is reached by skipping over previous statements because a zero 
resulted earlier, the expression is evaluated in the same way as for the l if, and has 
esame result (executing or skipping over subsequent statements). If reached after 
execution of statements because of an earlier nonzero l if or lelif. the expression 
is not evaluated; all subsequent statements up to the next matching lendif are 
skipped. As many I ellf tests as you like may be placed between an ! if directive and 
the I els* directive to perform multiple, mutually exclusive tests and conditional 
execution. 

* i 

The lelse directive can appear only between an I if or ! elif and the matching 
landif, and (unlike lelif) can appear only once during the sequence. If reached 
after execution of statements because of a nonzero test result, lelse causes all 
following statements, up to the matching lendif. to be skipped. If reached while 
skipping over statements because of a zero test result, It Is* causes execution of 
subsequent statements (up to the matching lendif). 

The lendif directive ends an lif... lelif... (else... lendif sequence. 


The l undef directive, which must be followed by the name of a macro, causes 
MAKE to forget the named macro. If no such macro exists, I undef has no effect. 

I include, which must be followed by the name of a file enclosed in quotation 
marks ( ‘namf), causes MAKE to evaluate and execute the entire contents of the 
named file before proceeding with evaluation of the current file. 
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The i error directive. which mu* he followed b> a ,c« suing. cat* ,hc ,<*, 
s,rins ,<> be displayed and then halts execution of MAKE. 

This version of M *KF. has no built-in inference rules;)< Jcfl 

saasssrisssarrsssc: 

denev file begins. 

Onlv wo of the three command modifiers used by NMAKE are valid for MAKE, 
. , recognized. Table 8.7 lists and describes the valid modifier 

characters. In both cases, these characters appear as prefixes to the comman mg 
modified. 




Disables error checking for the command it modifies; if 
modifier is followed by a number, MAKE halts only when exit 
code returned by command is greater than the specified 
number 

Prevents MAKE from displaying the command as it executes; 
identical in action with similar modifier for batch files in DOS 
version 33 and later 


Except for the differences noted in this section, Borland’s MAKE operates 
almost exactly like NMAKE. 


Creating and Using a Makefile with 
Microsoft NMAKE 

To create a dependency file, you must first decide which modules you want It 
to include All modules related to a single project should be handled by the same 
dependency file; if the name you assign to that file indicates a specific project, you 
can update everything by simply typing 


N”AKE project 

;.fter you make any source-file changes. If your dependency blocks are accurately 
written, all processef necessary for the update will be executed. 
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A5 an example of the w av MAirc 

for VIDEO LIB (a program devS'? * U5cd * ,ht ^ dependent, file 
with NMAKE: * 0pcd ,n Chapter 17, Video Memory") can be used 

» Makefile for VIDEO.LIB . 9/29/9, 


.asm.ob); 

"1 /c /C* /Zi /Fo*9 $•• ' 


video.lib : flndc.rd.ob, pchar.pp, „, ri n B ,„ 6j v 

pchsra.ob] pstringa.opj bos.obi \ 
setdi.obj scrn.ob) ** 

if exist video.lib del video.lib 
lib Bvideolib 

co M ,™a i ^'^ffler 5 < l V,DE f 0 ‘^eessemialsolciassicdependcncyfilc 

to process ASM '\ e* h ^ ,nf ^ re 2 cc ™ ,c 10 def,ne a desired invocation of Ml. 
0 process Here s how the file w orks. 

NMakT 1 '" NMAKE . iS „ execu ' ed - and «MO is specified as ,he dependency file 
Tha^^Mm ( K nd 0nl ” d ' P ' nd "’^ bl - k - <he file. Th,s is the one 
of the"colon 1 E ° UB “ ** “**« lnd “ composed of all ,he ODj files io ,he righi 

VIDEOuS F !fT E ! beC ‘“ '° Sure * h « ****r OB J S'* -w created before 
VI DEOU B If so, no action is taken; if not. the ODJ file is created by using the 

inference rule to create OBJ files from ASM files 8 

of VIDml m the f >mnund * *" the dependency block are executed If an old copy 
l “ “ de '" ed 11 ’' n UB EXE *» invoked to create the new 

follow!™ lnvoke d using a response file, VIDEOUB. which contains the 

video 


y 

♦ findcard.obj 4 

♦ pchar.ob) 4 

♦ P*tring.obj 4 

♦ pcbara.obj 4 

♦ Patringa.ob] 4 

♦ box.obj 4 

♦ setdi.obj 4 
4 acm.obj 
v iPeo.i*t 
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C:\>nioake If video 

Microsoft <H) Prograa cigM^rtsIr^d. 

Copyright (e) Microsoft Corp.'968-91. All right. 

■1 /c ICx 121 /Fopchar.obj pchar. ae« 

Microsoft <») M*cro A....bl.r V.rslon «.«« r „, rvM . 

Copyright (C> Microsoft Corp 1991-1991. All lg 

Assembling: pchar. asm 

if exist video.lib del video.lib 

lib •videolib 

Microsoft (A) Library Manager Version 3.10 r88erved . 

Copyright (C) Microsoft Corp 1903-1091. All g 


Library name: video 

LiDnry does not exist. Create7 (y/r<) y 
Operations: ♦ findcard.obj 4 
Operations: ♦ pchar.obi & 

Operations: ♦ pstring.obj 4 
Operations: ♦ pchara.cbj 4 
Operations: ♦ pstringa.obj 4 
Operations: ♦ box.obj 4 
Operations: + setdi.obj 4 
Operations: ♦ scrn.obj 
List file: video.1st 


C:\>_ 


Noie that YOU can override the effects of the Inference rule by stating an estpllct 
_ iq u ,e for any of the OBJ flies. For example, In the following dependency 

file: 

• MtKOfllS for VIDEO. Lie - 9/99/91 


.asn.obj: 

■1 /c 1C* /Zi /Fo$0 *** 

video. lib : findcard.obj pchar.obj pstring.obj V 
pchara.obj pstringa.obj box.obj \ 
tatdi.obj scrn.obj 
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if ..1st vldto.llb d.l video lib 
116 PvldSOUb "0116 


flndcard.ob] : f Indeed, aw 
"1 /* /Cx /Foflndcard.obj ,« ,indeed.,*., 
the inference rule is used to 

specific command under die ~7 o1h ^ ? BJ fi,CS exce P t FINDCARD.CBJ—the 
you can tailor your dependency fl. s bIock iS Uscd for ic In chis wa y. 

and maintaining your program files ° Vlrtually anythin 8 y° u want for creating 

Working with Profilers 

generally ^uscd^o^etwmtn^iheOTeran 161 ^' 5 lf>ro/,,er Bec;lu5e <his tool 

to determine which pan of your nrna P erfoi ™ance of a program, it can be used 
candidate for translation to assembl^^ge'” '‘ me ** therefore a 

ProfUe^^ilSc a «pa b rI^rp^e M “ T* 

Professional or Turbo Pascal Pmf^ T lan 8uage packages (Turbo C/C+ + 
Profiler has been a* for s^eXe"^ tJm ^ “V" C+ + ' Turt >° 

nrh^r Kin/i ™ ycara. The Microsoft Source Profiler * o rh#» 

available in 1991.” ** * Separate product pay more for it) and first became 

from Borland^ “ b °"’ tmakn -** lhe Pcodue, and then the produe. 


Using the Microsoft Source Profiler 

• ^ W,th a!I Microsoft language products, you can run the Source Profiler f P « m 

ms.de the Programmer s Work Bench environment, or you can run it from the DO* 
prompt. Once installed on your hard disk, the product is available from the Pwm 

focuTs »X“ 8 D0 S hOW<he S ° UrCC Pr ° fi,erWOrkl *" - -* section 

usi„ B TheTJ| h I Pr0fi,er ' y ° U T d ‘° com P ile - ssscmble, and link your programs 

pr« e m ! P, ‘°r r ^ haVC d ° ne this ' th ' enables you to 

7*c programs in any of four wavs: 7 

Q Coverage analysis 

Sampling analysis 


Scanned by CamScanner 



224 



□ Counting analysis 

□ Timing analysis 

Each type of analysis you "to quickly 

The profiler comes complete with a senes o 
use the programs from the DOS prompt. 

Coverage analysis simply tells you to discover 

used during a session. This type of anal\ sts is - . surpriS cd how often this 

whether any section of your code is not used (you d be ^rpr fl>rm 

happens in large programs). Using the batch files provided, you 
coverage analysis by using the following command lines. 

lCOVER filename (options) 

FCOVER filename (options 1 

The first line, using LCOVER, does a line-by-line coverage analysis; the seton 
docs a function-level analysis. 

Sampling analysis ignores your program most of the time 
intervals (you set the interval) peeks at your program to e:t. 5J full* 

execution process) the program is, and then records . 

scale profiling can slow down a program considerably, samp g , 

because it interrupts your program only occasionally, your program will run fas er 
Jhist be aware that the results of this type of profiling can be less than 
Using the provided batch files, you can perform sampling analysis * «th 8 

command lines: 

LSAMPLE filename [options] 

FSAMPLE filename ( options 1 

The fir* line, using LSAMPLE, does a line-by-line sample analysis; the second 
does a function-level analysis. 

Counting and timing, the analysis methods most useful to most programmers, 
deserve more in*dcpth examination. 


Counting Analysis 

This type of analysis simply counts how many times each function or line of 
your program is executed. This information may be helpful :n determining the 
“load" borne by each portion of your program. 

As an example of this type of analysis. I ran the FCOl'NT and (.COUNT batch 
files on TEST.EXE, the program developed in Chapter 5 for testing the SUMS rou¬ 
tine. The results of the function-level analysis (I'COt NT) were stored m the tile 
TEST .OUT, and appeared as follows: 
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Microsoft PLIST Version 1.00 


profile: Function counting, sorted by'counts 
Date: Tue Oct 01 07:32:25 1991 


Program Statistics • 


Total functions: 3 
Total hits: 731 
Function coverage: 100 . 0 % 

Module Statistics for c:\test.exe 


Functions in module: 3 

Hits in nodule: 731 

Module function coverage: 100.0% 

Hit 

count % Function 


365 49.9 status (test.c:14) 

365 49.9 sums (sums.asm:22) 

1 0.1 main (test.c:26) 

Because TEST.EXE contains only a few functions, the information provided 
may be of limited use. But on larger programs, this information can be quite helpful 
in determining how often certain routines get called. 

Using the same type of analysis on a line-by-line level yields the following 
information in TEST.OUT: 

Microsoft PLIST version 1.00 


Profile: Line counting, sorted by line. 
Date: Tue Oct 01 07:30:57 1991 


Program Statistics 


Total lines: 29 
Total hits: 201823 
Line coverage: 96.6% 
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Module Statistics for c:\test.exe 


Lines in module: 29 
Hits in module: 291823 
Module line coverage: 96.6% 


Source file: test.c 



Hit 



Line 

count 

% 

8ource 

l: 



/* File: TEST.C 

2: 



* Author: Allen L. Wyatt 

3: 



• Oats: 8/3/91 

4: 



• 

5: 



• Purpose: Program to test the calling of SUMS() 

6: 



*/ 

7: 




8: 



#include <stdio.h> 

9: 



* 

19: 



extern short sums(short); 

11: 



short status(short); 

12: 




13: 



short status(short orig) 

14: 

365 

9.2 { unsigned short new; 

15: 

365 

9.2 

new*sums(orig); 

16: 

365 

9.2 

if (orig>9 45 new—9) 

17: 

1 

9.9 

(printf("Sorry, the sum has exceeded cepacity 



(%u rows is too many)\n‘,orig); 

16: 



> 

19: 

1 

9.9 

else 

29: 

364 

9.2 

(printf("The sum of %u rows is %u\n‘,orig,new); 

21: 



> 

22: 

365 

9.2 

return (new); 

23: 

9 

9.9 

) 

24: 




25: 



void main() 

26: 

1 

9.9 { unsigned short j, x; 

27: 

1 

9.9 

j-8; 

28: 

5 

9.9 

while (J1*999) 

29: 

4 

9.9 

( printf(‘Initial Value: •); 

39: 

4 

9.9 

scanf(*%u‘,AJ); 

31: 

4 

9.9 

if (1l«999) 

32: 

3 

9.9 

{ x-status(J); 
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34: 

35: 

36: 

37: 


4 

• 1 
362 
1 


0.0 } 

J 2 .' f0r Xs1; x,-#; * =st *tus ()**)) 


0.0 } 

Source file: suns.asm 


Hit 

Line count 


1 

2 

3 

4 

5 

6 
7 
6 
9 

10 

11 

12 

13 

14 

15 

16 
17 
16 

19 

20 
21 


' Source 


Page 60,132 
Comment ! 


File: 

Author: 

Date: 

Purpose: 


SUMS.ASM for Microsoft Macro Assembler 6.0 

Allen L. Wyatt 

8/3/91 

Given an integer number X, find the sum of 
X ♦ (X-1) ♦ (X-2) ♦ (X-3) ♦ (X-4) ... ♦ 2 ♦ i 
Designed to be called from Microsoft C. 


Format: SUMS(X) 


PUBLIC sums 

.MODEL small, C 

.CODE 


22 

365 

0.2 

sums 

PROC 

o 

< 

H 

C 

• 

• • 

23 

365 

0.2 


MOV 

AX,0 

24 

365 

0.2 


MOV 

CX,value 

25 

365 

0.2 


JCXZ 

S3 

26 

65806 

32.6 

Si: 

ADC 

AX.CX 

27 

65806 

32.6 


JC 

$2 

28 

65805 

32.6 


LOOP 

SI 

29 

364 

0.2 


JMP 

S3 

30 

1 

0.0 

S2: 

MOV 

AX,0 

31 

365 

0.2 

S3: 

RET 


32 



sums 

ENDP 


33 






34 




END 



;Initialize to zero 
{Get actual value 
;Num-0, no need to do 
{Add row value 
;Ouit if AX overflowed 
{Repeat process 
{Successful completion 
{Force a zero 
{Return to C 
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This Information .how* a line-by-line profile of your program, which can be even 
more useful as you are attempting to fine-tune your programs. 


Timing Analysis 

Timing analysis Is particularly useful In determining ponlonsofs 

program are taking the most time. Then the functions that require the most time can 
be converted to assembly language to Increase the speed and efficiency of your 

programs. 

To Illustrate the output of the profiler for timing results, I ran the FTIME and 
LT1ME batch files on TEST.EXE, the program developed in Chapter 5 for testing « « 

SUMSroutine.Theresultsofthefonction-levelanalysls(FTIME)store n 

follow:. 

Microsoft PlIST version 1.00 

Profile: Function timing, sorted by time. 

Date: Tue Oct 01 07:30:12 1091 


Program Statistics 


Totsl time: 7003.032 milliseconds 

Time outside of functions: 2.912 milliseconds 

Cell depth: 3 
Total functions: 3 
Total hits: 731 
Function coverage: 1C0.0H 

Module Statistics for c:\test.exe 


Time in module: 7000.120 milliseconds 
Percent of time in module: 100.0% 
Functions in module: 3 
Hits in module: 731 
Module function coverage: 100. OH 


Func 

Time 

% 

Func+Child 

Time 

% • 

Hit 

count 

Function 

3904.531 

56.9 

4017.217 

57.4 

365 

status (test.c:i4) 

2902.903 

42.6 

7000.120 

100.0 

1 

main (test.c:26) 

32.606 

0.5 

32.666 

0.5 

365 

sums (sums.asm:22) 
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the status ^ncu'nll 1 ! r ° U ° ver half ,h * ,lme < 56 ’ Percent) was spent in 

function! does nor «. , r0ullne tha< does processing only and (unlike the main 

^rdilnZl user in f ut Thus ’ ifthis we« a time-critical program that 

needed improvement, the sums function would be a candidate for conversion. 

nwuluofdninlfriu e / 5 ^'v* * n *° fmation on a Ilne-by-llne basis is Informative. Hie 
res doing this (with the LTIME batch file) are stored in TEST OUT, as follows: 

Microsoft PLIST version 1.00 


Profile: Line timing, sorted by line. 
Date: Tue Oct 91 07:41:43 1091 


Program Statistics 


Total time: 7713.861 milliseconds 

Time before any line: 1.167 milliseconds 

Total lines: 29 

Total hits: 201623 

Line coverage: 96.6% 

Module Statistics for c:'test.exe 


Time in module: 7712.695 milliseconds 
Percent of time in module: 100.0% 
Lines im- module: 29 
Hits in module: 201823 
Module line coverage: 96.6% 


Source file: test.c 


Line 


Line 

Time % 


Hit 

count Source 


1: 


/• File: 

TEST.C 

2: 


• Author: 

Allen L. Wyatt 

3: 


* Date: 

8/3/91 

A * 

” • 


• 


E • 
w • 


* Purpose: 

Program to test 

ft • 

V • 


•/ 


7 * 

» • 




ft • 

V • 


(/include <stdio.h> 

Q • 

W • 
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19: 



extern short sums(short); 

it: 



short status(short); 

12: 




13: 



short status(short oriQ) 

14: 

1.442 

6.6 

365 { unsigned short new; 

IS: 

9.892 

6.6 

365 new*sums(orig); 

16: 

9.762 

6.6 

365 if (orig>6 &A new-6) 

17: 

' 16.599 

6.2 

1 {printf(‘Sorry, the sum has exceeded capacity 




(%u rows is too many)\n*,orig); 

18: 



> 

19: 

6.663 

6.6 

1 else 

26: 

3966.631 

51.4 

364 {printf(‘The sum of %u rows is txAft'.orig.new); 

21: 



} 

22: 

1.566 

6.6 

365 return (hew); 

23: 

6.666 

6.6 

6 ) 

24: 


- 


25: 



void main() 

26: 

6.666 

6.6 

1 { unsigned short J, x; 

27: 

6.663 

6.6 

1 j-6; 

28: 

6.664 

6.6 

5 while (jI*999) 

29: 

11.763 

6.2 

4 { printf(‘Initial Value: •); 

36: 

3576.825 

46.4 

4 scent(*%u*,4j); 

31: 

6.622 

6.6 

4 if (j1*999) 

32: 

6.665 

6.6 

3 { x*status(j); * . 

33: 



) 

34: 

6.664 

6.6 

4 > 

35: 

6.663 

6.6 

1 for (J-1. x«1; xl-6; x-atatus()♦♦)) 

36: 

6.774 

6.6 

362 ; 

37: 

1.737 

6.6 

1 > 

Source flit: sums.asm 



Lins 


Hit 

Line 

Time 

% 

count Source 

1: 

. • 


Page 66,132 

2: 



Comment J 

3: 



# 

4: 

5: 



File: SUMS.asm for Microsoft Macro Assembler 6.9 

6: 



Author:- Allen l. Wyatt 

7: 



Oate: 6/3/91 

6: 




9: 



Purpose: Given an integer number X, find the 6 u* of 
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10 : 

lis 

12 : 

13: 

14: 

IS: 


16: 

17: 

18 : 

19: 

29: 

21 : 

22: 

23 : 

24: 

25: 

26 : 

27: 

26: 

29: 

30: 

31: 

32: 

33: 

34: 


X ♦ <*-1) ♦ (X-2) ♦ (X-3) ♦ (X-4) ... ♦ 2 ♦ 
Designed to be called from Microsoft C. 


Format: SUMS(X) 


6.406 

6.300 

0.306 

0.137 

30.466 

56.796 

42.462 

0.443 

0.000 

0.387 




365 sums 
365 
365 
365 

65806 61: 

65806 

65605 

364 

1 S2: 

365 S3: 
sums 


PUBLIC sums 

•MODEL small, C 
. COOE 

PROC C Value:SWORD 

MOV AX,0 

MOV CX,value 

JCXZ S3 

ADC AX.CX 

JC S2 

LOOP SI 

JMP S3 

MOV AX,0 

RET 

ENDP 

ENO 


•Initialize to zero 
•Get actual value 
;Num«0, no need to do 
;Add row value 
;Quit if AX overflowed 
;Repeat process 
;Successful completion 
;Force a zero 
;Return to C 


° ri8lnaI “ urce cod * (tf aviibble In the current directory) is 
toduded In the report. Notice In the C source code that the output (printt) and 

«put (scan/) lines account for 97.8 percent of the programs time. Thus, instead of 

Zrl" 8 if end " 50015 routine ' 7° u "»y decide to simply improve input and 
uueput performance. 

lev _, < ?!' e 1 * h,n 1 8 ketp in mind with a timin g analysis, particularly at a line-by-line 
Dmfili that 1 dramaticalJ y slows down yopr program. Thus, completing the 
profiling process can take quite a while. TheSrwards, however, can be well worth 


Using Borland’s Tlirbo Profiler 

the M»l? rlan f * profiIcr has becn liable for some time (much longer. in fact, than 
m ^ osoft Profiler has been available). And Borland's Turbo Profiler is much 
compatible with their IDE (integrated development environment) concept. 
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When you load Turbo Profiler, the look and feel of the product is similar to the 
interactive modes of Borland’s other language products. 

Turbo Profiler is available with Turbo Debugger and Tools (<he stand-alone 
package that included Turbo Assembler 2.5) or with professional versions of 
Borland’s high-level languages, such as Borland C+ + or Turbo Pascal 6.0. 

Turbo Profiler enables you to perform a wide array of tests on your programs. 
You can test not only how often or how long files, modules, routines, or program 
lines execute, but also which computer resources— such as the disk, the keyboard, 
and the printer—are used. 

Interestingly, Turbo Profiler also gives you complete flexibility to totally 
control what you monitor and how you monitor it. This capability is much more 
powerful (and potentially confusing) than Microsoft’s profiler. 

This chapter focuses only on doing a quick profiling session to see how long 
each line of our program rakes to execute. Before you can use Turbo Profiler, you 
need to compile, assemble, and fink your programs, making sure that you include 
all debugger information wherever possible. (This example assumes that you have 
compiled, assembled, and finked the files detailed in Chapter 6.) 

Having prepared the files in this way, you can start Turbo Profiler with the 
following command: 

TPROF TEST.EXE 

which instructs Turbo Profiler to start and then load TEST.EXE. When this process 
is completed, your screen will look like the one shown in figure 8.1. 

The top portion of the screen shows the source code for the current module 
(in this case, the main C+ + program). The bottom portion, known as the Execution 
Profile window, displays statistics about any profiling tests already conducted. 

To start profiling, you must tell Turbo Profiler what you want it to check. You 
do this by specify ing areas to analyze. These areas can include files, modules, 
interrupts, overlays, or individual program lines. To specify which areas to profile, 
you can press Alt-F10. th- srandurd key combination Turbo Profiler uses to bring up 
a local menu The local menu differs according to which main window is active. 

Assuming (hat the sourcr-code window (the screen’s top window) is active, 
pres^i Ait F10 Now your screen should resemble the one shown in figure 8.2. 
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l.haplcr Additional Tools 


T//I. 8.1. /he Turbo I'rofilcr startup screen, with TliS'l.l-Xi loaded 


■ . lS “» ~IK“piloM indoM cId --irmnn 

•1.1-HodHle: test Fils: te ,tn-- . .“'A_, ,, .f™ 

!=► MOld Mint) . 

( 

unsigned short J. x: 

=► J=0: 

=► while (Jt= 999 ) 

*► ( cout « "Initial Ualuc: **; 

*► cin » J; 

»► if CJ»*9SS) 

*► < x=status(J>; 

> 


7 - Execution Profile -- 

-tyUl.tlee: 9 sec 
: M of total: 106 k 
d of 1 

Display: Tine 
. Filter: All 
- Sort: Frequency 

•f •••••..* • xx- 

• t 1 *• 

1 

£-i* *• u -' • • 

.• -•«. * . 

'V * , t '*.’ •*■« * 

. %. • a .?• tr*\ 

•’ *.«*. *r h 

**j -t 

• JX • • r 
.. \ 1 , 

• • .. . r. • *• 

•• .. •••:# ■rfV’Av- 

V * * . -a* • *> V • V 


-flenu 


F/g. 8.2. The local menu for the source-code window. 


| Us -.lew un tatistlcs rint ptlons Indaw elp" 

—la)Module: tent file: test.cpp 13- 
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\\ ith the local nu*mi displaced. y*>u want (o select Add areas. I hen select Every 
line in module, lints install migTin ho Profiler to monitor ami profile ex cry .source* 
code line in the C + + program. II you want Turbo profiler to monitor and profile 
even* line in the assembly language subroutine, you must select a dilfcivni module 
lor display in the source-code window. 

To do so. press Alt-I' It) apt in to bring up the local menu. Now select the Module 
option. Your screen w ill look like the one shown in figure H v 


Fig. 8.3. The module selection menu 



• { 

unsiijnrrt slwrt j, «; 

=► j-o. 

-► uhi!r (t 3 

*► < Lout << "hiiliitl Uahi*: 

=► cin >> j; 

-► if (j^O‘39) 


=► ( 

> 

_ 

x"sIaUis( j); 

* IV *. * 



! t, 

pi 1— ‘Pick a nodule ■ ■ 

| suns J 


• w 

. % ■ r 


V ± 

* • 


I I 




Ok • 

• 


Pick i 

•* ’ -* 

m item Tram the list 




From this menu you can select which module, sums or test, you want to work 
with. Because you have already done your work with test, simply press Enter to 
select the sums module When you do. the source code for SUMS.ASM should appear 
in the source-code window. 

Now you can select all the source-code lines in this module. As \ ou did with the 
<■-’+ + module, simply press Alt-ITU and then press A and E. Now you have informed 
lurbo Profiler that you want to monitor every line of the sums module, in addition 
to ex cry line of the test module. 

You are now ready to profile ific program. Do this by pressing I'd. The program 
runs normally albeit much slower than it docs from the DOS prompt. \ou should 
provide a few input numbers wlu n prompted. Enter the number to complete 
the program. 
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After 1E61.HXE runs vou t l 

should rcxl-mble the one in figure 8.4. * , r ° r,lcr S4Tl ' t n a P JI " Your screen 


Fig. 8.4. Tbe completed profiler screen. 



lie: sums 
P««e 66.132 

CoMw e nt I 


File: 


File: 

fitter: 

Rate: 

furpose: 


SltC.ASn for Turbo Assembler 3 0 

Allen L. Uystt 

KVlS/91 

5 iM *?w 4 ? ‘ nte » cr *- find the sum of 

* * (x-l) * <X-2) * <X-3) » (X-1) .. *2 

Designed to be called from Borland C.* 



Notice that the Execution Profile window is active and that the first item is 
highlighted. This highlighted item is the source-code line that took the longest to 
execute (about 40 percent of total execution time). You can see exactly which line 
it is by simply pressing Enter When you do. the source-code window becomes active 
and displays the source-code line that took 40 percent of execution time Notice that 
this line is *n the C+ + streams library, which has to do with COUT and C1N in this 
program. It is not unusual that these portions of the program should take the 
greatest percentage of time. 


Activate the Execution Profile window again, and press the down arrow a few 
Notice that the highest percentage of time taken by a line from SLMS.ASM was 
about 7 percent. If you press Enterwith this statistic h.ghlighted, you will notice that 
line is the loop directive in SUMS ASM. 


You can continue to work with the various displays and options in Turbo 
j™ier. Having had a glimpse of what it can do, you should realize that using it can 
be advantageous to your programs. 
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Summary 


in this chapter, you have learned about makefiles and P rofile "'.^°“ h *™ 
learned not only that judicious use of these makefiles can greatly stmpl.fy the task 
of your assembly language programs, but also how profilers can help 


you optimize your code. 

You have seen also the significant differences between the major make and 
profiler utilities. Which flavor you use depends, in large part, on which assembler, 
high-level language, and linker you use. 


Of the tools presented in this chapter, you probably will work most with 
makefiles, which can simplify your day-to-day programming tasks. But profilers 
should not be overlooked. You can use them toward the end of the development 
process to refine and sharpen your programs so that they are the best they can be. 
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Developing Libraries 


spcc^lnR f cach°fi , |TnI OUr aSS ® mb,y langua 8 c subroutines,“the process of 
number of routines Conside^fei” * un 7‘ el ^ y lf you uSt * n increasingly large 
section from one (and o^ o^^^^ f ° ,,OWln 8 declanZ 

——- ss: 

• #*«• -- 


OUTSIDE SUBROUTINES CALLED 
EXTRN SET_DI :NEAR 


• It* 


EXTRN 

EXTRN 

EXTRN 

EXTRN 

EXTRN 

EXTRN 

EXTRN 

EXTRN. 


CURS0R_0N:NEAR 
CURS0R_0FF:NEAR 
HORIZ_LINE:NEAR 
PRINT_CHAR:NEAR 
PRINT_STRING:NEAR 
ERASE_LINE:NEAR 
BOOP:NEAR 
CALC_LEN:NEAR 


^* yOU ?? in “8 ,ne ' ,h * “** of possible subroutines can become extensive To 

a s«c£m *7' y ° U 7" , Pl l" yOUr “ 5embl> ' ‘so*"*** OBJ flies Into a library 

a special file that is searched when you go through the linking process. 


The Advantages of Libraries 

When the linker finds an external declaration, It looks for the 
reference in the explicit OBJ file names you entered. If one of those fill doJTo 
contain the externai reference, the .inker searches for the refereTL,!£, 
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v»u named. If .he reference is located. .he linker extracts .he OBJ module and 

combines it into the executable file being created. 

This library concept relieves the programmer of several potential headaches 

(anderrors, in7hc progmnvdevelopmen.process. £ 

can simply update the library and recompile or reassemble all files that 

routine—quick, simple, and effective. 

In addition, the library greatly simplifies the task of * e 

necessary routines. In fact, without the library concept, you would not have thehigh 

level languages as you know them today. They all depend on their Itbrary routines 
to support input, output, and housekeeping requirements. 

But all these advantages that libraries provide are not restricted to software 
publishers; you also can create libraries that contain yourown ™stom.«d 
All you need is a library-maintenance program, and most assembler package 

include a library utility as part of the package. 


Library-Maintenance Programs 

Both Microsoft’s MASM and Borland’s TASM provide library-maintenance 
programs as part of the package sold with the assembler. Other library-management 
software is available from various vendors. 

Many library-maintenance programs are available, but to simplify our discus¬ 
sion this book focuses on a single system: a program (LIB.EXE) distributed with the 
Microsoft and IBM assembler packages. To show you ho*v similar the othcr ^“™ ry 
programs are, I’ve also summarized the commands and operations of TUB from 

Borland. 

Don’t be concerned if the descriptions that follow seem somewhat confusing; 
when you review them after you finish the chapter, Jiey should be much dearer. The 
actions controlled by the program options involve details with which you are not yet 

familiar. 


LIB from Microsoft 

The LIB program has only seven options (listed in table 91), and three 
operation codes that can in some cases be combined for a total of five functional 
operations. The options can be given either on the command line (immediately 
following the word LIB and preceding the first OBJ file name), or in response to the 
first prompt. 
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tables.I. LIB opt lons 

Option 

n 

/Help 

/Ignorecase 

/NOIgnorecase 

/NOExtdict 

/NOLogo 

/PAgesize: 


Meaning ~ ' — 

Display quick help screen 

Start extended help system 

Force all symbols to uppercase 

Do not change case of any symbols 

Do not create extended dictionary for library 

Do not display the LIB introductory information 

Set increment of storage space used 
(normally 16 bytes) 


<•> - W » - ■ the tninus sign 

Wing and relocating 

sections on creating'a Ubnuy°and maintaining""hbray ™' 0 '' 5 ' h ‘ S cha P ler s 


TLIB from Borland 

Borland’s TLIB program has the same three operation codes as im^ 

*e following pair; 118 eVCn fc " er options than LIB, however ^pro^ding only 

□ /C flags case (when used, TLIB becomes case-sensitive) 

Q /E creates an extended dictionary. 

Q IPsize sets storage space page size. 

TLIB’s /c option is the same as LIB s /NOI option and TLIR\ if ■ u 

opposite of LIB’s /NOE option. If neither option is used TLIB corw P T 
symbois to uppercase and does no. create emended ^o«Hes PUb " C 
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Creating a Library 

YOU create a iibraty by using oneZSZGZS 
enter the examples in this book, you wi 1 ^ table 9-2). Be sure that the 

subroutines thaftanbejoined togeiherInto* h In this session. 

OBJ files created for these/foutlnes are available; you win use_ 

TMe 9.2. Available flies to be placed to a library fife 


111 


File Name 

Chapter 

CEX3.ASM 

13 

CLREOL2ASM 

11 

readscrn .asm 

12 

SUMSASM 

5 


Function 

C cursor switch 
BASip dear to end of line 
Pascal screen read 
Linker example for C 




Using LIB 

Let’s look first at how to use the software from Microsoft and IBM to create and 
nodify libraries. Like MASM and LINK, UB has several ways of getting .ts input d 
3nly the interactive method is discussed in this section; 1 explain the others later. 

Make sure that you have the Microsoft UB. EXE program on a floppy disk eiiher 
,n the current directory or accessible through a Search path. Then, at the DOS 
prompt, type the following command: 

LIB 

to execute the UB.EXE program. You will see on your screen a notice and prompt 
similar to the following: 


C:\>LIB 


Microsoft (R) 
Copyright (C) 


Library Manager Version 3.18 

Microsoft Corp 1983-1991. All rights reserved. 


Library name: _ 

If vou arc using the IBM version of LIB EXE. or a version of LI B which came with 
something other than MASM 6 0, your screen will look a little different Because 
prompts are similar, vou should be able to follow this session 
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standard libranexaction (LIBMs'a t '''’Tl^ trtalc l,ctallM ' lht ' 

sion is entered, the full name of this' libr ,n is TESTMIJ Wl’ Un,C! “ an °" K ' r l ' XK '"' 
following prompt is displayed: hcn >' ou P"”* ">c 

Library name: TEST 

Library does not exist. Create? (y/n) _ 

Becau« i you r °a?e P creinno ST*?, 100, in Ca5C >’ ou n,is5 P flled th --’of the libran. 
looks like this 8 W l,brary ' preS5 Y MKr » >u P«*» Enter , your screen 

Library does not exist. Create? (y/n) y 
O perations: 

TEST UB*The^three'fvi*?[° rma,ion =>bout the operations you wan, to perform with 

ingthe 'e blsiecommsn? addin * dcle,in 8- copying By combin- 
g tnCs e basic commands, you can periorm rwo additional operations For instance 

you can replace a library entry by deleting the old and then adding *e new “ you 

can move the entry by deleting it at its original location and then copying the entry 

a, a new location. Table 9.3 lists the available LIB operations. 


Table 9-3- LID operations. 
Operation 


Function 

Add an OBI file as a library entry 
Delete a library entry 
Copy a libran entry 
Replace a library entry 
Move a libran- entry 


Because you are creating a new library, you don 't need to delete, copy replace 

or m° ve an entry. You want to add OBI files to the new library-; to do so. enter the 
following at the Operations: prompt: 

+CEX3 +CLRE0L2 +READSCRN +SUMS 

Ob, “m."' 1 " 1 IO add 10 ,hc ncwl > coated and still empty libran the 

created in ' ” * S (CEXJ OB| - CLRE0 ‘ 2 OB '- RTADSCRN.OBI, and SUMS.OBI) -ou 
cated ,n the chapters listed in table 9.2. (OBJ ,s the default file extension,: ' 

., wam to add any of the other OBI files created in this book, you can. Just 

3 p us sign and include the name ol the OBJ file. You may not want to add some 
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of the examples from Chapter 11. -Interfacing with BASIC." however. The examples 
in that chapter which apply only to interpretive BASIC are not suitable for inclusion 

in a library. 

If the operation commands you give to I IB run long, you can enter the 
commands on individual lines as follows: 

Operations: +CEX3 +CLRE0L2 A — 

Operations: -*-READSCRN +SUMS 

The ampersand (&) at the end of the first line signifies that more follows. Use 
it if you cannot fit all the desired operations onto one command line. 

Finally, the following prompt appears on the screen: 

Operations: +CEX3 ♦CLRE0L2 +READSCRN +SUMS 
List file: _ 

A list file, which is optional, contains reference information you may find 
interesting and helpful. If you do not want a list file, simply press Enter; but here, 
for the sake of illustration, enter TEST. LST as a file name. Be sure to specify the LST 
file extension because LIB does not provide a default extension for list files. 

After a few moments, the DOS prompt returns to the screen, signifying that LIB 
has created the library TEST.LIB. If any errors occur during the process of creating 
a library, an error message is displayed. (In some instances, notification of the action 
taken bv I.IB is displayed also.) 

To get an iuuu • >f \\ hat happened during the process of creating the library, look 
at the list file that a created. If you type TEST. LST, you should see the following 
display: 

C>TYPE TEST.LST 


CLREOL. 

. . .clreo.? 

READSCRN. . 


...readsern 

CurSw. 

.. .cex3 

sums. 



c i line 

cex3 

Offset: O0000010H 

Code 

and 

data 

• • • dlfHlO 

size: 7bH 

_CurSw 






Clreol2 

Offset: 000001 c0H 

Code 

and 

data 

size: 6dH 

CLREOL 






readsern 

Offset: 0CO00360H 

Code 

and 

data 

size: 62H 

P.EADSCRN 






sums 

Offset: 000004aOH 

Cooe 

and 

data 

size: 72H 


sums 


C 
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The list file (in this case TFST i <t\ . r 

created library: the names ol thi*.ms i V. ' ,nfams information about the newly 
where each module begins and th i* ^ "V C ,hrary * as "ell as information about 

you can seeZt ,hc ,hc om *"!* "?"**• From lhis ™ LST file, 

label SUMS that the mnHi i k * extension is assumed) contains the public 

Noteihat a leZngunden!c«t or'- nS * 1 ' a Fllt ol,sl;l <’f L30h. and that us length is 72h. 
use with C programs The link • CS1 ^ moclulc name of modules prepared for 
assembler adds it automatically becZ* <_ pru ^ rams IO h -* v,: lhis underscore; the 
wan. to use the C language model ^ "" d in lhe sourcc file th “ >">“ 


Using TUB 

Make sure you have the TUB EXE program on a floppy disk, in the current 
?ouZZ command^ C ' hr ° U8h ‘ ^ Tht "' “ - P~-P«. 

TUB TEST +CEX3 +CIRE0L2 +READSCRN ♦SUMS, TEST. LST 

This tells TUB to create or update the library TEST.LI 13 ado om 

modules (CEX3 OBI. CLRE0L2.0BJ. READSCRN.OBj. and' SUMs ouj, and m 
create a listing file. TEST.LST. JJ ’ to 

After you enter the command, the following is displayed on-screen: 

TLIB 3.01 Copyright (c) 1991 Borland International 

C: \>_ 

Tha !’^ a " ‘ hCrC IS to i,! Your llbn,r >' We is now created. If vou had entered the 
incorrectly, or an error had occurred, an error message would hav e 

shown "° pr ° blemS occur durin 8 librar >- «««ion. no messages are 

Here is die listing fde (TEST.LST) you asked TUB to create: 

Publics by module 

<?EX3 size , 123 
CurSw 


CLRE 0 L 2 size « 109 
CLREOL 
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readscrn size ■ 98 
REAOSCRN 


SUMS Size =114 

Although TUBS listing file is much 'md 
i, gives you all the h , i$(s sizes ln he ™decimal. theTUB repon 

^nTecl“ Wh^mal^ it much more comprehensible to the average reader. 


Using a Library 


Now .ha, you have learned how to 
specific details that 1 point out as appropnate. 


Linking with a Library 


UUII5 —-' 

.. ^ chaDte[S 5 and 6, one of the UNK prompts asked which 
As you may '«»“ Because ubraries had no, ye, been discussed, 

libraries ,0 use in J he L " kl " 8 ^ ^deferred to this chapter. Now that you have 
the discussion of linking librar . oro cess again ,0 see how 

created a library (TEST.UB), you can perform the Unking process g 

TEST.LIB affects the process. 

When you enter the UNK command at the DOS prompt, your screen shoul 
look like this: 

Microsoft (R> Segmented-Executable LinK.r Version 5.13 
MicrosoTT » A11 rights reserved. 

Copyright (C) Microsoft Corp 1984-1991. 

Object Modules (.OBJ): _ . iti 

,.. _ n u iect file used in Chapter 5), and then, to s«g«^ 

Object Modules I-OBJ]: test 
Run File [teet.exe): 

List File [NUL.MAPJ: _ 
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Because you do not need a list file f or 
comes the important question: 


this example, simply press Enter. Now 


List File (NUL.MAP); 
Libraries (.LIB): 


to use to link this file. If yoITemerseve^u Lb Ubnr> ’ ( ° r ,ibiarie *> >' ou wanI 
You don't have to include a file extension ' hCm ’ 

Enter. UNKubn^tonh^ (TEST. LI Bj. simply type test and press 

First, all the specified object files are link” | g ,° CS * h "T* ° n ' he Casks >OU specificd * 
TEST ORli TKpn •( mked together (in this case, there is onlv one- 

sa 

to TEST.OBJ. e m ° U ' Conulnin8 the syrnbo1 is extracted from TEST.L1B and linked 

SUMSrn?'°' hCr unres °'''«l f»emal references remain (in other words, if the 
.SUMS routine contains any references that cannot be satisfied intemaUv to SUMS 
or in the TEST OBj file), die library is searched again This search-and-includ'e 

be resolted n !iN^ PO “‘ b ' referenceshav<: been resolved. If some references cannot 
solved, LINK generates an error message and the linkage process stops. 

If an error message such as the following occurs: 


C:\>iINK 

Microsoft (R) Segmented-Executable Linker Version 5.13 
Copyright (C) Microsoft Corp 1984 - 1991 . All rights reserved. 

Object Modules [.OBJ]: test 
Run File [test.exe): 

List File [NUL.MAP]: 

Libraries [.LIB]: test 

Unresolved externals: 

_sum$ in fiie(s): 

TEST.OBJ (test.C) 


There was 1 error detected 
C:\> 
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vou know that LINK could not find the subroutine in the object file (TEST.OBJ) or 
in the library (TEST LID). Usually, this means that you have forgotten to include all 
necessary files in the library. Check your work again and try the linking procedure 
one more time. 


Creating and Using Library Response Files 

With LIB. as with LINK, you can provide a file (cleverly called a response file) 
of responses to questions. Because repeatedly typing answers to each question is 
tiresome, this method of using LIB is beneficial when you know that you will be 
adjusting a library time and again during development. 

To use this method of providing input tc LIB. create an ASCII text file that 
contains the answers to each question. You can give this file whatever name you 
want Just be sure to place the answer to each question on a separate line. For 
instance. I regularly create a new library of all my assembly language subroutines by 
using the following LIB response file: 

\assemble,Huge.lib 
Y 

♦ \assemble\obj\asciibin & 

+ \assemble\obj\box & 

♦ \assemble\ob]\boxita 4 

♦ \assemble\obj\calclen 4 

♦ \assemble\obj\cdir 4 

♦ \assemble\objNclrvmdow 4 

♦ \assenble\obj\cls 4 

♦ \assemble\obj\conascii 4 
+ \assemble\obj\conhex 4 

♦ \assemble\obj\concase 4 

♦ \assemble\ob]\crc 4 

♦ \assemble »ob)\cur soft 4 

♦ \assemble\ob]\curson 4 

♦ \assemble\obj\dait 4 

♦ \assemble\obj\dayt 4 

♦ \assemble\obj\direct 4 

♦ \assemble\CD)\eraselne 4 

♦ \assemble\objindcard 4 

♦ \assemble\obj\fmenu 4 

♦ \assemble\obj\fsize 4 

♦ \assemble\obj\getkey 4 

♦ \assemble\obj\getli.ie 4 
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4 \assemble\obj\getlinea & 

♦ \a$semble\obj\getyn A 

♦ \assemble\obj\h 0 ri 2 A 

♦ \assemble\obj\invert A 

♦ \a 8 Sembie\ 0 bj\mbindiv & 

♦ \assemble\ob]\mencom & 

♦ \assemble\ob]\flienuar & 

4 \assemble\obj\menubox & 

4 \assemble\obj\message & 

4 \assemble\ob]\motr A 

4 \assemble\obj\pauztick & 

♦ \assemble\obj\pauztime & 

♦ \assemble\obj\pchar & 

4 \assemble\ob)\pmsg & 

4 \assemble\obj\pnum A 

♦ \assemble\obj\pstrng A 
4 \assemble\obj\pstrng2 & 

♦ \assemble\ob]\qscreen A 
4 \assemble\obj\sbox A 

♦ \assemble\ob]\scrn A 

4 \assemble\obj\scrnbas A 
4 \assemble\obj\seekey A 
4 \assemble\obj\setcolor A 
4 \assemble\ob]\setdi A 
4 \assemble\obj\soundasm A 
4 \assemble\obj\soundbas A 
4 \assemble\obj\tbox A 

♦ \assemble\obj\timer A 

♦ \assemble\ob]\vidbas A 
4 \assemble\obj Widdata 
\assemble\huge.1st 

♦ 

Notice the response on the second line of this file, the letter Y, which is there 
to answer the following question: 

Library does not «xist. Create? (y/n): _ 

LIB asks this question if it cannot find HUGE.LIB. The construction of this 
response file presupposes that the original library (if any) has been deleted. The Y 
response causes LIB to combine into HUGE.LIB the 52 specified object-code files. 
The ampersand (&) at the end of each line (except the final file-specification line) 
tells LIB that additional commands follow. Finally, LIB is directed to create a list file 
called HUGE.LST. 
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If you arc using TUB, omit the Y line from a TUB response file bccaute TUB 
docs not ask the Create? question. Otherwise. TUB works exactly the same way at 
UB, even though it has no interactive mode to imitate. 

To use a response with UB, simply invoke LIB with the following command 
syntax: 

LIB 9filename.ext 

or, if you are using TLIB, use the following syntax: 

TLIB ^filename.ext 

where filename. ext is the name of the response flic to be used. Notice the @ symbol 
immediately preceding the flic name. LIB needs this key symbol to differentiate 
between a response file and a library name. 

If the sample response file were called HUGE.LRF, you could use It by issuing 
the following command: 

LIB 0HUGE.LRF 

As you repeatedly use LIB, you will appreciate being able to use response files. 


Maintaining a Library 

After you become accustomed to the idea of creating libraries to keep 
collections of similar assembly language routines together in one place, and to using 
libraries when you create programs, you come face-to-face with the need to maintain 
your libraries. You need to add new routines or change old ones, and you may even 
want to extract routines from one library and add them to another. 

This is all made simple by the library-managing programs. First I’ll show 
you how it’s done, by correcting the conflict that showed up earlier as TEST.LIB 
was created. Then I’ll discuss some techniques to help make the entire library- 
management task easier. 


Making Changes to a Library 

Changing a library file is as easy as creating one. By using the commands to 
delete, add, copy, replace, or move, you can update an existing library to meet 
current needs. For example, let’s assume that you have made some changes to the 
file CLREOL2.ASM. You reassembled the file, and now you need to add the new OBJ 
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file to TEST.LIB to replace the 
using the following dialog: 


old CLREOL2 


C:\>LIB 


module. You can update TEST.LJB by 


Microsoft (R) Library Manager Version t 10 
copyright ,c, Microsoft Corp , 963 . e „ 

4 1091 • A1 * fights reserved. 

Operations: -+clreol 2 
List file: test.1st 
Output library: 

C: \>_ 

manager pro^m't^delae Wht ^ '* ° penition code ’ u ’ hich told the library- 
append (♦> a new copy fromVu^^^^ 

new version gf the CLREOL2 module. P ocess u P dates TEST .LIB with the 

output library is assumed to have the same name as the original 
i rary is saved as a backup (in this instance, as TEST.BAK). 

What if a module you want to add is in another directory or on another disk? 

£SSE? neCeSSlry inf0nna,i0n “ the Op * rations •• >">“«»• “-the 

C: \>LIB 


Microsoft (R) Library Manager Version 3.18 

Copyright (C) Microsoft Corp 1983-1991. All rights reserved. 


Operations: -clreol2 +d:\obj\clreol2 
List file: test.1st 
Output library: 

C:\> 


Notice that you indicate the deletion and addition as two separate steps The 
result, however, is the same as in the previous example. 

To modify the library in other ways, simply specify the operation you want 
Hrnormed (refer to table 9.3) and the name of the file module you want to modify. 
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A, you add files u> your library, you can follow either of two avenues usually 

taken b/programmers: you can create each 

nient location) all your subroutines, or you can create 
representing a specialized category of subroutine. 

Let s assume that you want to manage only one large library and * a ‘; 

,o 

to smaller libraries, as well. 

The usual process for updating a library is as follows: 

1. Assemble the source file. 

2. Delete the original OBJ file from the library. 

3 Add the new OBJ file to the library. 

, „ s Msumc that your library is called HUGE.L1B and that, to make matters 
more complicated, you need to update several files You can update your l.brary . 
using the following batch file (UPDATE BAT) to perform the three steps: 

£echo off 
els 

del *.obj >nul 

del \assemble\hugelib.txt 

: loop 

if %1\ == \ goto exit 

echo Working on Hi.asm 

echo Assembling Hl.asm »\asssmble\hugelib.txt 
ml /c /Cx /FoHl.obj IF 1 Hi.asm »\assemble\hugelib.txt 
echo Adding Hl.obj to HUGE.LIB »\assemble\hugelib.txt 
Uu \assemble\huge -+H1; »\assemble\hugelib.txt 

shift 
goto loop 

:exit 

del *.obj >nul 

This batch file assumes that MASM and LIB are in the current directory or the 
search path, that the source file (ASM) is in the current directory, and that you wan, 
HUGE LIB to be in the subdirectory ASSEM 
The proper syntax for this batch file is 
UPOATE file I file? file3 file4 .... 
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where filei is the root file name of the ASvi n . 

filel. file* and so on arc ihc optional nam ^ "I bc l upda,cd in ,h,: llbrar V fit*!. 
updated to the library P L ' s <>f mhlJr source lilcs that you want 

MASMandUBissaved^(inthttASSEMBLE^ "h, 1 ," 6 ' lht ' dia) ° 8 n ° rmall > Presented by 
Any errors are noted in ^s fi^Tce ,he “rT* in 3 " ecalted «UtaUB-WT 
dtan the usual >; dtis forces e«h s“« of the” ” ^bol. tather 

end of the file. If you use the > symbol *° append i,s messages to the 

will be in HUGELIB.TXT. ead ’ ° n y the reporl from the last LIB run 


Summary 


r 

This chapter has shown you how r to rr#»ar/» r u,„ , 
how libraries fit into the linking'procesT "b'" 8 '' lnd manage libraries »"<* 

tasks muTeuier"’' adeP ‘ “ USi " 8 y ° U Wi " r,nd that *** can make your 
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Mixed Language 
Programming with 
Assembly Language 
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Interfacing Subroutines 

w y h : u n i?^ c rnzr„r 8e 5ubn,u,i "” w,,h 1 high " vei ,a ~ 

□ How the subroutine is invoked 

□ How parameters are passed 

□ How values are returned 

111,5 C Jl apt< ; r d ° cs not attcm P t to address the specifics of all these points Thr 
itty-gntty details of each of these considerations are covered in Part II- mi h 

Language Programming (Chapters 10 through 15). The way you invoke an assem'blv 

wITh’fh T H " C ' f ° r eXan,pk ' Spends on the h.gh-level language tom 

Whrch ihai subroutine is called. The information in this chapter is more or le« 

fTT" !° the process of mterfacing assembly language subroutines, no matter 
which high-level language you may be using. 

Ut f loo * cfirsl at how Parameters are passed to assembly language subroutines 
Later in this chapter you will see how values are returned to a high-level language 

Passing Parameters 

from rH”!*" 1 '; ,h ' 5 “ ck is U5ed to pxss parameters to subroutines. As you learned 
«n«I on™' ? Craandin8 ,he Pro * ra "'"»"8 Environment; the stack "s a 
cx^mn ' V ° "" i “ Sing " “"“O' “ -o successful program 


Scanned by CamScanner 


Not all languages pass parameters on the stack. Parameters can be passed also 
in the CPU registers or in some other memory area (usually ca e zparame ir 
block). Neither of these methods is widely used, however; you P ro y ^' use 
them only when you work with DBMS languages. Chapters 1 4 an iscuss ese 

methods in more detail. 


Because each high-level language uses memory in different ways, a common 
area is needed for subroutine interfacing. The accepted standard for this area is the 
stack. If you push the parameters on the stack before you call a subroutine, the 
subroutine can access and modify the data. To prepare for the discussion o ow 
parameters are accessed on the stack, let’s look at how the data is place on t e stac 
and how parameters are formatted. 


How Parameters Are Placed on the Stack 

Although the specifics of how parameters are pushed on the stack are 
determined by the type of data the parameter represents and which high-level 
language you use, individual parameters usually are passed either as data values or 
as pointers to the values. 

Normally, if the parameter is a short numeric integer (16 bits or less), its data 
value is pushed on the stack. If the parameter is an alphanumeric string, a pointer 
to the string is passed. A parameter that is a large numeric integer or a floating-point 
number can be passed by either method. 

Because parameter placement differs from language to language, later chap¬ 
ters cover the specifics for each language. 


How Parameters Are Formatted 

Individual parameter format may vary from language to language. For 
instance, if the data value of a floating-point number is being passed on the stack, 
the high-level language you are using determines the way in which the number is 
encoded. 

Parameters must occupy at least one complete word (16 bits) on the stack, 
although, depending on the high-level language, additional words can be used. If 
that one word is a pointer to the variable in the high-level language’s data segment, 
the translation of the data at that memory location will differ from language to 
language. The number of bytes each data element uses is particularly open to 
variation. Again, later chapters cover specifics for parameter format. 


Scanned by CamScanner 



Accessing Parameters on the Stack 

Two methods can be used to access information passed through the stack 
(these methods translate to the same method when your assembly an^ge 
programs are assembled) The routines in this book use simplified segmiTand 
' "?! a8e ' SpeClf ' Ca "f" d,rect,ves found in both MASM and TASM. These directives 
Then the “ S M Clfy 'Z plain EngUsh thc ' ype ofanguage you are interfacing with. 

Then the assembler takes care of accessing the parameters on the stack. 

't o” thr S ' mpUf,ed la "guage directives are available only for such general- 
Tvat^t r r ° 8ram 7 ng guages “ BASIC . C, Pascal, and FORTRAN. They are not 
ri,tlh b f speclflcpur P os<: languages such as database languages. If a specific 
database passes parameters through the stack, they must be accessed usi^ the 

pointer, 'introduced mtthapter l^ 60 ' COd ' ng access us ' ng the BP register (the base 

In older incarnations of MASM and TASM, the BP register was used for 
accessing information on the suck. This register is used as a secondary suck pointer 
pnmanly for accessing dau on the suck relative to a given location. The simplified 

rectives referred to a short time ago actually translate into instructions that use BP 
to artess the stack. 

The specific way you use the BP register depends largely on the type of 
su routine being called. Let’s look at the contents of the stack when the assembly 
anguage subroutine is a near procedure. Even if you are using the language 

irectives, an understanding of how the assembler accesses parameters on the stack 
is important. 

stack ir.'T'T 15 inVokcd ’ each individual parameter Is pushed on the 

stack, followed by the calling program s return address. In a NEAR procedure this 

return address is the segment oflset-technically, the incremented contents of the 
■TOtrucdon pointer (IP) register. Thus, at the sun of the assembly language 
subroutine to which three 16 -bit parameters are being passed, the suck woullkjk 
luce the one shown in figure 10 . 1 . 

like those' n^pjre^Tlklb were a FAR procedure, thc suck contents would look 
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Fig. 10.1. Stack at beginning of execution of a NEAR procedure. 


_ mi _ 

_ rrn _ 

_ ??77 

777? 

high byte of return address offset 

low byte of return address offset * • —stack pointer 

■ - ' J (SP) is here 


Fig. 10.2. Stack at beginning of execution of a FAR procedure. 


—stack pointer 
(SP) is here 


???? 

_ ???? 

high byte of return address segment 
low byte ol return address segment 
high byte oI return address offset 
low byte of return address offset 


Notice that invoking a FAR procedure involves pushing one additional word of 
data. This word is the segment of the calling program, technically the contents of 
the code segment (CS) register. 

Other than the number of bytes pushed for the return address, the information 
for both procedures is in the same format and in a predictable position on the suck. 
To accesc the information, you simply set the BP register and use offsets to retrieve 
values from the stack. The following code segment shows the proper way to do this 
in a near procedure, assuming that the parameters have been placed on the suck by 
a C compiler and that each occupies 16 bits; the code segment would be slightly 
different for other languages: 


PARMA 

EQU 

4 

PARIIJ5- 

EQU 

6 

PAAM_C 

EQU 

8 

TEST 

PROC 

NEAR 


PUSH 

BP 


MOV 

BP, SP 
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AX.lBPJ-PAfiMA 
BX, (BP}♦PAflM_8 
CX, (BP J +PARM_C 


• ^est of program goes here 


.Ki. *' men ’ l * r *•"' on en “y. ,hc stack looks like the one shown In fieure 2 1 At 
thu potm. the return address occupies die two bytes a, s.ackX,^" h ,h 

parameters begin with the byte at ofise, 2. To save the contents of die BP renter' 
however, you must push the register on the suck. After you push BP on « J 

rerem add° f ^ ^ IWO byxes at stack ofifeet °- Allowed by the two-b^te 

rerum address; the parameters then begin at an offset of 4. * 

The next instruction sets BP equal to the current stack pointer (SP\ whirh 

k P COmaim thC SQCk 0fiket address of the old BP value. Because you 
know that the parameters begin at offeet 4, you can access them through indirect 
addressing, using BP and an offset. ^ ircct 

end °f the subr °utinc, you must pop BP off the stack. Doing so leaves 
Because a call to a faa procedure results in an additional word on the stack the 

'° U ’ e PrcCedi " 8 ^ * th “ ° f X" 

p ARM_A EQU 6 

PARM_B EOU 8 

PARM_C EOU 10 

^r b < S nS, ' e$ f ° r th ' idd " i0nal word P llMd a«ck when the fab 

the ,ilT*“ r “ ndersund how Bf « used to access parameter information on 
c stack you should understand also that using the simplified language directives 

wnnM . ^! Cr T 3710 aCCCSS P arame,e »- ^ code segment just discussed 
would look like this if you used the simplified directives. 
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TEST 

PROC 

NEAR C PAAM_A:WORD, PARM_B:W0RD, PARM_C:WORD 


MOV 

AX,PARM_A 


MOV 

BX,PARM_B 


MOV 

CX,PARM_C 

; REST OF 

PROGRAM 

GOES HERE 


RET 


TEST 

ENDP 



Notice how much shorter the code Is. The assembler takes care of the routine 
work; since you have declared at the beginning of the procedure that you will use 
the assembler to pass information from C, it knows how to translate the three MOV 
instructions in the body of the procedure. Your Job as programmer is made simpler. 


Returning Values 

Values usually are returned from an assembly language subroutine in one of 
the following ways: 

□ Through the stack 

□ Through a register 

Q Through memory 

None of these methods is automatic; you must predetermine how you will 
return values. The high-level language with which you are interfacing is the major 
determinant for selecting which method to use. Some languages require thatyou use 
a certain method; others, such as C, allow some programming flexibility. 

Let’s take a look at each method. 


Returning Values through the Stack 

The stack can be used not only for passing parameters but also for returning 
values. For example, if the calling program pushes four unsigned integer numbers 
on the stack before calling an assembly language subroutine, the subroutine can use 
and even modify these four words of data. On return to the controlling program, the 
four values remain on the suck. The controlling program can retrieve and use these 
values, which may have been altered by the subroutine, in some languages, this is 
' a common way to pass information to and from a subroutine. 
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Returning Values through a Register 

Because ^Tex^cie^freg^fer varies frum^T i rCtUm * rcgl5Urr 

v C;;° ^ 

gramuscTih^^klwi^g'comniandtincio'invokfio^^^^ly^^^ subroutine-^ 

x=*whi2bang(); 

expeewd’^d w'Ih^ ' hC PU , rP °'l 0f ,he "^routine, a return value is 

X expeted fo^rr " ' V3nablc ‘ ^ fo ™“ ° f « rhe 

ren,rn..rt P d f " c aS ' ,um ' : lhal ‘ ,s a l6 * b " integer, a value can be 

i a register, such as AX and then the high-level language will assign the 
contents of AX to the variable This is how 16-bifvaiues are ™™d inC 


Returning Values through Memory 

J f y °“ r high ' lbv ' 1 ' an * u: '8<r passes pointers to data, instead of passing data 
values, you can modify high-level language variables directly. 

When passing string variables to a subroutine, many high-level languages pass 
only a pointer to the string s memory location. Because the length of the string mav 
vary, passing the entire string on the stack is unrealistic. Using the pointer however 

I ™‘ “““ lh ' S ‘ r ; n 8 direc,| y and evcn changes to it (the changes are then 

available to the high-level language). 

This method has powerful possibilities but also has a drawback. For example 
an assembly language subroutine cannot readily change the length of a string 
ganging memory allocation is dangerous when that allocation is under the control 
° a high-level language Many pointers and assumptions that affect the high-level 
nguage s use of the variable may be in play and. by changing the data length vou 

dan ° VCrWntC ° thcr data or inva Mate other pointers. Either of these possibles is 
dangerous to successful program execution. ^ * 

Inn Y ° Uca ” P^ventmostpotentialproblemsbyrnakingsurethatyoupassastring 

“ y re “° nable amOUn ' ° f dlU you -W» n«d »Tum. For 
Pe L rmilS 5tringS ^ “ man y M 255 long: therefore, passing 
string , 5 IOy ° Ur r ° Utine P rovides buffer space big enough to handleany 
in rt» g hC Unguagc P erm,| s If you know that you will never need more chan 64 bytes 
me return value, however, passing a 64-byte string will be adequate 
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Other Considerations 

In addition to the observations already made about the stack and its use, I want 
to point out several other considerations. Mainly, these are tips for you to keep in 
mind when you do any programming that manipulates the stack. 

As you’ve learned, additional data (I call it overhead data ) is pushed on the 
stack when a procedure is invoked. One item of this data—the return address for the 
calling program—is common to all high-level languages. 

Inadvertently changing this overhead data can, and usually does, have disas¬ 
trous effects. For example, if the return address is modified, program execution does 
not resume at the proper point in the calling program. If you are lucky, the entire 
system may “hang" and require rebooting; if you are extremely unlucky, control 
could accidentally drop into the DOS routine that reformats your hard disk! 

A more common error is failure to remove information that was pushed on the 
stack or failure to restore the suck pointer properly after using the suck for 
temporary storage This leaves the stack “dirty." Figure 10.3 illustrates what may 
happen if you inadvertently leave an extra word of dau on the suck. 



When a RET (return) instruction is executed, execution resumes at 0CA8:0041 
instead of at 126F:0CA8 (the proper return address). The return address varies 
according to what is left on the stack. And the results of this error vary, depending 
on die memory contents beginning at the erroneous return address. This address 
may be in the program or, as in figure 10.3, it may be somewhere outside the program 
area. To solve the problem of program execution that does not continue as you want 
it to, make sure that everything pushed on the suck is subsequently popped off. 

Then execute the return. 
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A similar error occurs il you pop too much data from the stack; execution 
continues at an unintended memory address. 

These two errors bring up an interesting (and potentially devastating) possi¬ 
bility. which has already been mentioned. Many hard disk manufacturers include a 
set of low-level routines in ROM. These routines, which include low-level hard disk 
formatting and other preparation software, lie quietly in wait until you call them— 
either purposely or inadvertently. It is possible, although unlikely, that an erroneous 
return address on the stack could cause program execution to resume at a memory 
address located at the start of the formatting code for the hard disk (or other 
dangerous code). The results could be devastating. To guard against such a 
possibility, back up your hard disk at regular intervals, and make sure that your 
routines leave the proper return address undisturbed. 


Data Manipulation Tips 

■When working with data passed to assembly language subroutines, you 
should follow several safety guidelines: 

1. Never manipulate data values unless you need to. 

2. Use intermediate working variables or registers during execution of 
assembly language subroutines. 

3. Always remember to leave the stack as it was when the routine was 
called. The stack should be free of extraneous data. (Simplified 
language directives handle much of this for you in the latest assembler 
versions.) 

4. Make sure not to pop too much data from the stack. 

5. De r ermine your subroutine procedure ahead of time, and make 
allowance for it. Is it NEAR or FAR? The type of subroutine affects how 
data is accessed. 

6. Take special care to preserve the calling program’s return address 
unchanged. 


Summary 

Because different high-level languages use memory in different ways, a 
common way to pass information to assembly language subroutines is mandatory 
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1 he accepted method is to pass information on the stack, where that data can be 
accessed by the assembly language subroutines. 

This chapter introduced and explained some general concepts, but did not 
cover language-specific information. In the following five chapters, you will discover 
how to interface specific high-level languages with assembly language subroutines. 
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Interfacing with BASIC 


B ASIC (Beginner’s All-purpose Symbolic Instruction Code) is perhaps the most 
popular of all computer languages. Its free-form structure, easy English-like 
vocabulary, and low cost make it the most widely distributed language in the world 
of microcomputers. 

Although BASIC is popular, it has several shortcomings that have caused some 
people to disdain the language and other people to adopt apparendy unorthodox 
methods of circumventing the problem areas. 

BASIC’s slowness is its most serious and memorable legacy. 1 use the word 
legacy because many newer implementations of BASIC, most notably QuickBASIC, 
are compiled languages that have overcome the slowness of yesteryear. Yet the bad 
reputation for slowness persists with many programmers. 

BASIC began as an interpredve language; indeed, many interpretive versions 
of BASIC are still available. In these versions, every line of source code is parsed to 
its machine language equivalent when the code is executed, a process that ultimately 
slows down BASIC programs. The only reliable way to get arounckhts problem is to 
use a BASIC compiler, which translates the BASIC source code into machine 
language for subsequent execution. Using a compiler gready increases speed but 
also increases development time and destroys the interactive nature of the language. 
The frustration of this dilemma was somewhat alleviated after Microsoft’s QuickBASIC 
and Borland's TurboBASIC (now called PowerBASIC) were introduced, however. In 
environments like these, you get both the interactive advantages of interpretive 
BASIC and the increased power and speed of a compiled language. 

To overcome the slowness of interpretive BASIC (and some compiled BASIC 
routines), many programmers have resorted to the technique of reducing time- 
consuming procedures to their assembly language equivalent, and then combining 

265 
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them with .he BASIC program. This technique, which ^ a ^ ~ , wi,hou ' pC " K 
i5 the o pe of assembly language inierfacmg covered in .his eh.ip.er. 

Those who turned lo compiled BASIC seemed 10 solve the speed problem- 
for a whde lB.VTs BASIC compiler (in.roduced in .he early 1980s and made .o work 
w .roOS versions prior to 2 0) did no, suppor, such features as hierarchical 
directories and path names, but programmers could use assembly anguage su r u 
tines ,o sidestep these deficiencies. Many programmers converted other rou^ ^ 
assembly language; execution time for those routines w racio and 

newer compilers such as QuickBASIC. TurboBASIC (now called PowerBASIC). and 
the Professional Development System (PDS) from Microsoft removed many of the 
barriers to compiler use. 

This chapter examines both interpretive and compiled BASIC. First. l et s loo k 
a, the process of interfacing with interpretive BASIC. The next couple °f*cuo™ 
deal with GW-BASIC and BASICA. the BASIC Interpreters distributed wtth every 
version of DOS through 4.01. Shortly. QBasic, the interpretive BASIC that comes 
with DOS 5 0. also is discussed. 


Working with GW-BASIC or 
BASICA 

Shielded from the computer's day-to-day, machine-level intricacies, most 
interpretive BASIC programmers do not have to concern themselves with where 
code or data reside, or how peripherals are interfaced with the computer. The BASIC 
reter takes care of all these matters behind the scenes. A limited number of 
,nl mands enable you to examine BASIC’s internal workings more closely, however. 
These commands, which include vaapta and DEF SEG, are not used frequently in the 
course of normal. BASIC-only programming. 

You can use several methods to interface assembly language subroutines with 
BASIC This chapter focuses on two methods: storing short routines in string 
variables and storing long routines in a set position in memory. Each method is well- 
suited for different types of subroutines, depending on their length., 


Interfacing Short Subroutines 

You can enter short subroutines directly into memory by placing them in the 
riable space used by BASIC strings. These subroutines must (by definition) 
be short because, under interpretive BASIC, strings cannot be longer than 255 

characters. 
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To place an assembly language subroutine into a string, follow, these steps: 

1. Determine the length (in bytes) of the machine language subroutine. 

2. Set.aside a string variable equal in length to the number of bytes deter¬ 
mined in Step 1. 

3. Move the subroutine, byte by byte, into the memory space occupied by the 
string variable. 

After completing these steps, you can call the subroutine at any time by simply 

calling the address associated with the string variable. 

To understand this method of interfacing an assembly language subroutine, 
let’s look at a practical example; because interpretive BASIC has CLS but no “clear 
to end of line" capability, let’s create a subroutine that provides it. First comes the 
actual assembly language coding: 

Rags 69,132 
Comment J 


File: CLREOL.ASM 

Author: Allen L. Wyatt 

Date: 6/17/91 

Purpose: Subroutine to clear screen fro* current cursor position to end - 
of line. Designed to be called from interpretive BASIC. 

Format: CALL D <--• 0 is the address of the subroutine 


PUBLIC CLREOL 

.MODEL large,BASIC 
.CODE 

CLREOL PROC 


MOV 

AH,9Fh 

; get video mode data 

INT 

16h 

; using BIOS function 

XCHG 

AH, AL 

; set up COLS data 

XOR 

AH,AH 


PUSH 

AX 

; and save it 
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MOV 

AH,03h 

; get current cursor pos 


I NT 

10h 



XOR 

DH,DH 

; ignore row 


POP 

CX 

; get width back 


SUB 

CX.DX 

; calc number left on lir 


MOV 

AX,0A20h 

; write char only, blank 


I NT 

10h 


- • 

RET 



CLREOL 

ENDP 




END 




This simple little subroutine first checks how many character positions are on 
a line (since BASIC can have either 40 or 80 columns), then finds out which column 
the cursor is currently in, calculates how many characters are needed to reach the 
end of the line, and finally writes that many blank spaces, starting at the current 
position, without moving the cursor. -Ml of this magic is done by three calls to the 
video BIOS routine. 

After completing the three steps outlined at the beginning of this section, you 
must then determine the number of bytes required by the preceding routine. To 
make this simpler, you can use the following BASIC program after you have 
assembled the assembler source program into an OBJ file: 

10 * 

15 * 

20 ' 

25 * 

30 ' 

35 * 

40 * 

45 ’ 

50 ' 

55 * 

60 * 

05 ' 

70 ' 

100 CLS 

110 LINE INPUT 'Name of OBJ file to analyze: *;FI$ 

123 IF FI$ S ** THEN END 

.30 IF INSTR(FI$, ". * 1*0 THEN FI$=FIS+*.OBJ* 
r a OPEN FIS FOR RANDOM AS #1 LEN * 1 
150 FIELD # 1 , 1 AS AS 
160 P s 1 


File: 

OBJREAD.BAS 

* * * 

Author: 

Allen L. Wyatt 


Date: 

8/17/01 


Purpose: 

Analyzes an OBJ file created by masm or TASM 



displaying the data values necessary to poke* 



short assembly language subroutines into 



string space. 

» t • 
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170 GET #1, P : P = p ♦ i 
180 IF ASC(A$) = 160 THEN 220 
190 GET #1, P 
200 P = P + 2 + ASC(A$) 

210 GOTO*170 
220 CLS 

IT 1 USe the f0ll0wino data statem ents in your program:' : PRINT 
240 GET #1, P : p = p + 5 

250 N » ASC(A$) - 4 

260 PRINT '1000 DATA*; N; 

270 L « 1010 

280 FOR J * N TO 1 STEP -1 

290 IF Z ■= 0 THEN PRINT : PRINT USING *#### DATA *; L; 

300 IF Z > 0 THEN PRINT 

310 Z « Z + 1 : IF Z « 10 THEN Z=O:L»L +10 

320 GET #1, P : P b p + 1 

330 PRINT RIGHT$(*0*+HEX$(ASC(A$)),2); 

340 NEXT J 
350 PRINT 
360 CLOSE 

This program runs in GW-RASIC, BASICA, or QBasic. It reads your OBJ file and 
displays on-screen the appropriate DATA statements to be used later. Translated to 
machine language by means of the assembler-OBJREAD route, the CLREOL routine 
consists of the following 24 bytes: 

84 0F CD 10 86 E0 32 E4 50 B4 03 CD 10 32 F 6 59 2B CA B 8 20 0A CD 10 C 8 

Knowing this, you can create a string 24 bytes long for this routine. Of the many 
ways available for creating a string, one is as good as another; pick the method you 
find most comfortable. In the following sample BASIC program, I have used the 


SPACE instruction: 

15 * * 



20 1 * 

File: 

CHI1A.BAS • 

25 * * 

Author: 

Allen L. Wyatt * 

30 * * 

Date: 

6/18/91 • 

35 • • 



40 * • 

Purpose: 

Sample program to show poking an assembly • 

45 * • 


language subroutine into BASIC's string variable * 

50 ’ • 


space. Designed to work with GW-BASIC. * 

55 * * 


* 

DV ■ 

65 1 



100 CLS 
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2~Q " M,wd Langu age Programming with Assembly Language _ 

DEF FN AOR(X$)=256•PEEK(VARPTfi(X$)*2)+PEEK(VARPTR(X$)♦1) 

120 RESTORE 1000 

130 READ NUMBYTES 

140 MOOULE$ s SPACE$(NUMBYTES) 

150 FOR J=1 TO NUMBYTES 

160 READ VALUES ' * 

170 MI OS (MODULES ,J,1)*CHR$(VALrSH •♦VALUES)) 

100 NEXT J 
190 LOCATE 10,1 

200 PRINT ’This line will be cleared from HERE on to the end;*; 

210 PRINT * press any key now.'; 

220 WHILE INKEYS=":WEND 

230 LOCATE 10,36 

240 D=FN ADR (MODULES) 

250 CALL D 
26*> END 
1G00 DATA 24 

1010 DATA B4,0F,CD,10,86,E0,or,E4,50,B4 
1020 DATA 0S,CD,10,32,F6,59,2B,CA,B8,20 
1030 DATA 0A,CD,10,CB 

Notice that the byte values which make up the subroutine are co ntaine d In 
data statements at the end of the program. The first DATA statement (in line 1000) 
in- :icates the number of bytes in the subroutine. These lines were created using 

OBJREAD.BAS. 

Lines 120 through 180 read and act on the DATA statements. Line 170 stores the 
values into the variable space ofMOOULES. These lines can be used, unchanged, to load 
any assembly language module into string space. 

Lines 190 through 260 test the routine to show that it works. The two LOCATE 

statements position the cursor appropriately, and the WHI LE... WEND loop in line 220 

provides the time delay so that you can see what is happening. 

Notice line 240, which is used to determine the physical address of MODULES. 
Through the use of the function definition at line 110, the address is determined by 
using the string descriptor (maintained by BASIC) that specifies the length and 
location of variables, look again at line 110: 

lie DEF FN ADR(XS)«2S6*PEEK(VAAPTR(XS)+2)+PEEK(VARPTR{XS)+1) 

varptr returns the address of MODULES. In this case, because we are working with 
a string, the address of the string descriptor Is returned. This descriptor consists of 
three bytes that give the string's length and address. Because the length is unimpor¬ 
tant in this case, you need to use the first and second offset bytes at the descriptor 
address. 
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tk ^ CSe °^ set ^ es specify the address in memory of the first byte of MODULES 
The address is assigned (in line 240) to the numeric variable D. Because MODULES 
contanis the machine language subroutine that should be called, line 250 passes 
trol to that routine, starting at the first byte of MODULES (whose address is in D). 

• t . y ° u may wam to clcar a portion of the screen in a different color 

without using the BASIC color-setting capabilities. By slightly rewriting the routine, 

TV ^ ^ 10 aSSCmbly linguage a that specifies the color attribute to use, 

as in the following assembly language program: 

Page 60,132 
Comment ! 


File: CLRE0L2.ASM 

Author: Allen L. Wyatt 

Date: 8/18/91 

Purpose: Subroutine to clear screen from current cursor position to end 
of line. Designed to be called from interpretive BASIC. 

Format: CALL D(A%) 

D ■ Address of subroutine 

A% ® Attribute to use when clearing 


PUBLIC CLREOL 


I 

I 


CLREOL 


.MODEL large,BASIC 
.CODE 


PROC Attribute_Address:WORD 


MOV 

AH,0Fh 


INT 

10 h 


XCHG 

AH, AL 


XOR 

AH,AH 


PUSH 

_AX 

• 

• 

MOV 

AH,03h 

• 

I 

INT 

10 h 

• 

XOR 

DH.OH 

■ 

9 

POP 

CX 

• 

I 

SUB . 

CX.DX 

■ 

t 


get video mode data 
using BIOS function 
set up COLS data 

and save it 

get current cursor pos 

ignore row 

get width back 

calc number left on line 
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MOV 

SI,Attribute_Address 


MOV 

BL,|SI1 


MOV 

AX,0920h ; write char ♦ attr, blank 


INT 

I0h 


RET 


CLRE0L 

ENDP 


■> 

END 



The two versions of the assembly language routine are noticeably different. 
This rewritten version is 11 bytes longer, and all the added bytes of code are used 
to obtain the attribute value from the calling BASIC program. 

The variable is passed through the stack. When the CALL statement is executed, 
BASIC pushes the variable’s address on the stack. Thus, to access the parameter 
value, you must first retrieve the pointer from the stack and then use the pointer to 
load BL with the parameter value itself. 

Not quite so obvious is the change in the BIOS function call that writes the 
blanks to the screen. This call now tells the screen to use the attribute value in the 
E\ register instead of the one already on-screcn. Without this change, all the rest 
\ ould be wasted. 

You also must change the BASIC program that uses this routine for passing a 
value. The modified routine follows: 


10 ’ 

• 



• • 

15 ’ 

• 




20 ' 

• 

File: 

CH11B.BAS 


25 1 

• 

Author: 

Allen L. Wyatt 


30 ' 

+ 

Date: 

e/ie/91 


35 ’ 

• 




40 ‘ 

• 

Purpose: 

Sample program to show poking an assembly 


45 ‘ 

* 


language subroutine into BASIC's string variable 


50 ' 

• 


space. Designed to work with GW-BASIC. 


55 1 

fih 9 

• 

O 4 

• 


> • 


65 ’ 

100 CLS 

110 D£F FN ADR(X*)=256 * PEEK(VARPTR(X$)+2)+PEEK(VARPTR(X*)♦1) 

120 RESTORE 1000 

130 READ NUMBYTES 

140 M0 DULE* m SPACE$(NUMBYTES) 

ISO FOR J*1 TO NUMBYTES 
160 READ VALUE* 
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170 MI D$(MODULES ,J,1)-CHR$(VAL(*4H*+VALUE$)) 

180 NEXT J 
190 LOCATE 10,1 

200 PRINT ‘This line will be cleared from HERE on to the end;*; 

210 PRINT * press any key now.*; 

220 WHILE INKEY$=* *:WEND 

230 LOCATE 10,36 

240 AV*4H10 

250 D=FN ADR(MODULES) 

260 CALL 0(A%) 

270 PRINT 

280 PRINT ’The clearing will be UNDERLINE if mono, or BLUE if color.* 

290 END 
1000 DATA 35 

1010 DATA 55, 8B, EC, B4, 0F, CD, 10, 86, C4, 32 

1020 DATA E4, 50, B4, 03, CD, 10, 32, F6, 59, 2B 

1030 DATA CA, 8B, 76, 06, 8A, 1C, B8, 20, 09, CD 

1040 DATA 10, 50, CA, 02, 00 

Notice that thte only modifications to the routine are in the invocation (lines 
240 and 260) and in the DATA statements that begin at line 1000 (after all. tlfcs 
assembly language routine is longer than the first). 

Some new lines are added (lines 270 and 280) to verify that control returns to 
BASIC properly after the routine is CALLed. 

In line 260, note especially that the variable being passed to the routine (A\) 
is an integer variable. Integer variables are extremely easy to work with in assembly 
language. They require only two bytes in the BASIC variable area and can be accessed 
as word values in assembly language. This routine would have been far more 
complicated had the % integer flag been left out! 


Interfacing Longer Subroutines 

If a subroutine is more than 255 bytes long, or if you are not comfortable 
placing the subroutine into a string variable, you can place it directly into memory 
by following these steps: 

1. Determine how much space to reserve for the assembly language 
subroutine. 

2. Use the CLEAR command to set aside the necessary memory space. 

3. Poke the subroutine into the reserved area of memory. 
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Even though this process is particularly well-suited to subroutines longer than 
255 bytes. I use the same routine as the previous example to demonstrate the 
process. This routine has no coding that would render it static, and it is “ relocatable ,” 
which means that it will function properly no matter where it is placed in memory. 
Interfacing is relatively easy. This type of routine gives programmers few headaches 
and little trouble. 

To reserve memory for this routine, you use the CLEAR command with a 
designation specifying the highest memory address that BASIC can access. BASIC 
ordinarily uses a full 64K segment. (64K is essentially equivalent to FFFFh.) By 
subtracting (from this unlimi ed amount) the amount of space you want to reserve 
for your assembly language routines, you can determine a new ceiling limit to use 
in the CLEAR statement. 

For example, this subroutine, which occupies 35 bytes of memory, and an 
additional 10 similar routines would need perhaps one full K of memory. Subtract¬ 
ing 400h (IK) from FFFFh results in FBFFh—the address (FBFFh, or 64511) to use 
with the clear statement in the BASIC program. The process is shown in the 
following routine: 


10 • 

• 



• 000 

15 * 

* 




20 ' 

• 

File: 

CHI1C.BAS 


25 * 

• 

Author: 

Allen L. Wyatt 


30 ' 

• 

Oate: 

8/18/91 


35 ' 

• 




40 ’ 

• 

Purpose: 

Sample program to show poking an assembly 


45 * 

• 


language subroutine into BASIC's high memory 


50 * 

* 


area. Designed to work with GW-BASIC. 


55 * 

60 ' 

• 

*0 



0 *# 


65 • 

100 CLEAR ,64511! 

110 D=64512! 

120 CLS 

130 RESTORE 1000 
140 READ NUMBYTES 
150 FOR J=1 TO NUMBYTES 
160 READ VALUES 

170 POKE 645imj,VAL{*SH**VALUE$) 

180 NEXT 

190 LOCATE 10,1 

200 print 'This line will be cleared fro* HERE on to the end;“; 
210 PRINT ■ press any Key now.*; 

220 WHILE INKEYS=**:WEND 
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230 LOCATE 10,36 
240 A%*&(10 
250 CALL D(A%) 

260 PRINT 

270 print *Ths clearing will be UNDERlinf if 

280 END LINE "ono, or BLUE if color.* 

1000 DATA 35 

1010 DATA 55, 08, EC, 84, 0F, CD, 10 86 ^ 32 

DAT* s.. B4, , 3 , co. 3J ; £ £ % 

1030 DATA CA, 8B, 76, 06, 8A, 1C, 88, 20, 09, CD 

1040 DATA 10 , 50, CA, 02, 00 . ’ 

tine resides at one static location. In this example theass^mhivi* . 

(645l2) C,elriy ' m ’* «»h!^“ 

the beginning address whenever you want to invoke the routine. 


Working with QBasic 

QBasic is the interpretive version of BASIC distributed with DOS 5.0. If you 
ve installed DOS 5 on your machine, you may have noticed that GW-BASIC is 
gone-it is no longer part of the DOS package Microsoft distributes. If for some 
ason you prefer GW-BASIC to QBasic, you can always copy GW-BASIC from the 
disk see of an older version of DOS; it should work properly. 

If you want to work with QBasic, however, you must realize that some things 
nave changed when interfacing assembly language subroutines. The syntax and 
internal structure of the language are now more closely akin to QuickBASIC than tn 
GW-BASIC. 


Because it is closely akin to QuickBASIC, one of QBasic’s features is that it 
handles longer strings than earlier interpreted BASICs. As you may recall, string 
length in GW-BASIC and BASICA is limited to 255 characters. QBasic’s length (in it 
b * 2 ’ 767 characters. This means, first, that you can store longer routines in a string 
and second, that you must change the way you call those routines. 
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,ha. regardless of the implementation, BASIC stores strings using 
Remember that B • • diseus<!e |j [hu5 hr _ lhis string descriptor was three 

for the length and two for the offset address. 

This means that changing the 

necessary, but changing the BASIC programs .s necessary. The yu 
CHI 1 A BAS, presented earlier in this chapter, follows. 


File: 

Author: 

Date: 

Purpose: 


CHI ID.BAS 
Allen L. Wyatt 
8/18/91 

Sample program to shorn poking an assembly 
language subroutine into SASIC'S string variable 
space. Designed to work with QBasic. 


defint A-Z 
CLS 

RESTORE 1080 

READ NumBytes 

Modules = SPACES(NumBytes) 

FOR j = 1 TO NumBytes 

READ Values . ... 

MIDS (Modules t J. .1) - CHR$(VAL(*4H* ♦ ValueS)) 

NEXT j 

PRINT 6 *This line will be cleared from HERE on to the end; 
PRINT * press any key now.'; 

WHILE INKEYS » 


OEF SEC * VARSEG(Modules) 

Address* - 256 * PEEK(V* °TR (Modules) - 3) - 
LOCATE 10. 36 

CALL ABSOLUTE (AddreSS&) 

END 


PEEK(VARPTR(MOduleS) 


♦ 2 ) 
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100® DATA 24 

DATA B4,0F,CD,10,86,E0,32,E4,50,B4 

DATA 03.CD,10,32, F6 ,59,28,CA,B8,20 
DATA 0A,CD,10,CB 

proba^rnmictdriThr^ S ° mC obvious and othc ™ subtle. First, as you 

versions of BASIC is I ™£d S^“ nUmbCrS ™ S SimiUri '’' lo con 'P‘ ,ed 

Second, notice the block of calling code, as shown here: 

DEF SEG * VARSEG (Modules) 

LOCATE^ 36 6 * PEEK < VARPTR < Module *) + 3> ♦ PEEK(VARPTR< Modules) ♦ 2) 
CALL ABSOLUTE(Addressl) 

The VAHSEG and varptr functions are still used, but then the actual string 

Onl"* “ by looki " 8at third "> d fourth byres of the stringdescriptor 

nly the address of the descriptor is returned by VARSEG and VARPTR. 

1D(ft ° ncc addrcss is calculated, the old call statement is changed to call 
ASSOLure, wh.ch tells QBasic that a memory address is being called, rather than a 
named subroutine in the BASIC program. 

The changes in the program for passing parameters are similar to those just 
discussed. The QBasic program for use with the enhanced version of CLREOL 
appears as follows: 


Fil»: CH11E.BAS 

Author: Allen l. Wyatt 

Date: 8/20/91 

Purpose: Sanple program to show poking an assembly 

language subroutine into BASIC’s string variable 
space. Oesigned to work with QBasic. 


DEFIMT A-Z 


CLS 

RESTORE 1000 

READ NumBytee 

Modules = SPACES(NumBytes) 
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FOR j * 1 TO NumBytes 
READ Value! 

MID$(Module$, j, D - CHR$(VAL(*&H* ♦ Values)) 

NEXT j 

LOCATE 10, 1 

PRINT ‘This line will be cleared from HERE on to the end; ; 

PRINT * press any key now.*; 

WHILE INKEYS • **: WENO 

A = AH10 

DEF SEG = VARSE6(lloduleS) 

Address* = 256 • PEEK(VARPTR(Modules) ♦ 3) + PEEK(VARPTR(Modules) ♦ 2) 

LOCATE 10, 36 

CALL AB$OLUTE(A, Address*) 

PRINT 

PRINT 'The w.-aring will be UNDERLINE if mono, or BLUE if color.* 

END 

1000 DATA 35 

DATA 55, 8B, EC, B4, 0F, CD, 10, 86, C4, 32 

DATA E4, 50, B4, 03, CO, 10, 32, F6, 59, 28 

DATA CA, 88, 76, 06, 8A, 1C, B8, 20, 09, CD 

OATA 10, 5D, CA, 02, 00 

The only change here worth mentioning is in the use of CALL ABSOLUTE. Notice 
that the parameter being passed is placed before the address of the subroutine. This 
differs from the older BASICS, in which the parameters effectively followed the 
address. 


Compiled BASIC 

Several compilers for BASIC exist, but the least expensive and apparently most 
popular is Microsoft’s QuickBASIC, which is now at version 4.5. All the compilers 
vary slightly from each other, the examples in this chapter were written and tested 
with QuickBASIC 4.5. 

Although normal interpretive BASIC offers quick development time, compiled 
BASIC programs require a few extra steps. With earlier compilers, you had to run the 
source programs through the compiler and linker. QuickBASIC gives you the option 
of doing program development in an integrated environment or of using a com¬ 
mand-line compiler. With either option, program development takes place in an 
environment that makes the compiling and linking steps essentially invisible. 
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may be as many as 32 767 bi ll f e i a,l °" to QB«ic-is tha. strings 

assembly language roufinesTmo ZL ' d ‘ ffcrcnce ,haI in5,ead of !»>“"« 
QuickBASIC environment the toutin /OU 0,1 ClU thcm by lheir namcs In Ihe 
you can call them; with the command mUS *”7 a Quick L,brar > Q LB flle before 
program by using the LINK imigr«.‘^^^^SM I “ nl,ed “ ,he BAS,C 

one The LINK process takes ca4of the ri^f ^^u ^ SUbr ° U ' 

eatnoUed'BASR-Tm ° f h ° W '°,' merface assc mbly language subroutines With 
i .? . . . ^ ® rams ’ consider the enhanced version of CLREOL oresented 

■er in the chapter. To use this routine in the QuickBASIC environmen. all that’s 
necessary ,s to pu, i, into a QLB file No change to the routine ts requueu 

To create a QLB file containing just the CLREOL routine, use LINK with the 
lOUtCKLie option switch as follows. The CLREOL routine is asromed ro iTm tl 
current directory, the LINK operation creates Quick Library MINE.QLB. 

C:\QB>link /q clreol2,mine, ,bqlb45; 

Microsoft (R) Segmented-Executable Linker Version 5.13 
Copyright (C) Microsoft Corp 1984 - 1981 . All rights reserved. 

LINK : warning L4845: name of output file is , «ine.qlb‘ 


Notice that UNK provides a warning message to let you know that the library name 
differr rom that of the OBJ file. This message can be ignored; it does not indicate 
any kind of true error. The BQLB45 library must be specified to create a QLB file. 

Once the QLB file exists, you can cause QuickBASIC to use it during a 
development session by typing the following: 

C:\QB>QB /LMINE 


This brings the QuickBASIC environment into action, loading library file 
MINE.QLB into memory. Inside the environment, you can type in the following 
QuickBASIC program: * 


279 
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File: CHI IF.BAS 

Author: Allen L. Wyatt 

Date: 8/20/91 

Purpose: Sample program to demonstrate using an assembly 
language subroutine wit* 1 a QuickBASIC 4.5 
program. 


DEFINT AZ 
CLS 

LOCATE 10, 1 

PRINT ’This line will be cleared from HERE on to the end, , 

PRINT * press any key now.* 

WHILE INKEYS ■ WEND 

LOCATE 10, 36 
a * 16 

CALL clreol(a) 

r .nt 

, :nt ‘The clearing will be UNDERLINE if mono, or BLUE if color. 

Note the total lack of any setup routine or DATA statements—the only difference 
between the programs. 

If vou want to verify that the attribute value is actually being passed through and 
used you can change the value assigned to a just before the call statement. On a 
color monitor, a value of 32 produces a green background, 48 creates cyan, 64 
results in red, and so on up to 112, which specifies white. The code is simply 16 times 
the normal color value, but color values must be from 0 through 7; higher values are 

handled mod 8. 

As you may have noticed, the procedure for calling assembly language 
subroutines in this program is a good deal simpler than the corresponding 
procedure for interpretive BASIC (because you don’t need to worry about poking 
or addresses). 


If you use the command-line compiler rather than the environment, you don’t 
even need to create the QLB file. In this case, combining the assembly language 
subroutine with the BASIC program is accomplished through the LINK process (as 
described in Chapter 4, “Choosing and Using Your Linker"). 
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Summary 


luwtteS 1 ^ y ! e and extremel >’ P°P U| " computer Ian- 

wrfct’iw and ** make “ sembl ) r language subroutines 

attractive and. in some instances, necessary to the viability of a program. 

whether^he^AMr*^ imeriac ‘ ng “«nibly language subroutines depends largely on 
. ^ program is written in interpretive or compiled BASIC. Each type 

h “ thl< how «■» '-gu*ge interacts JS3 

passes variables to assembly language subroutines. 

with P«2a. neXt Chap,er yDU lelm hOW ,0 in,ert,ce “sembly language subroutines 



Scanned by CamScanner 




Scanned by CamScanner 




Interfacing with Pascal 


P P^S^mming language that first appeared in 1970, has a loyal following 

t !? UngUagC S stnjctured »PP"»ch to programming. Pascal 

readily available for most computer systems at a moderate cost, with Borland 

W " n * thc Uon ’ s share of market with their Turbo Pascal compiler Such 
availability has added to the language s popularity. 

mMn^M an y°* cr computer language. Pascal “bogs down" in certain areas. I don’t 
m^ to imply that Pascal is unacceptable; it’s just slower than assembly language in 
certain areas. As a result, many programmers have developed assembly lanauaae 
subroutines to interface with their Pascal programs. language 


General Interfacing Guidelines 

„ ™ e . Wly yOU *■» “ Sembly Ungu> * e «*n>u«nes with Pascal pro- 

^ by YOUr peno,ul P^e^nmlng style, and to a leLer 
oaent by th e P val compUcr you are using For example, using either Microsoft's 
QukkPasaU or Borland s Turbo Pascal, you can Include machine language code by 
me ans pf the tnun, ( | statement or by automauc Inclusion of OBJ Dies though thl 

i*.. * * (before version 4.0, Turbo Pascal provided ,h. 

lnUn«() capability). The choice of methods to use is left to you. X 

use a two-step approach to program development. Once 
P . source code is compiled and then, in the second step, linked. If your 

^^compiler uses this two-step approach, you can incorporate assembly language 

only by “ semb “ ng ^ subroudn « ““ 

283 
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Inline Routines 

When you use the inline () capability to include assembly language subrou¬ 
tines in Pascal programs, the subroutines must be completely “relocatable" and fully 
self-contained. In other words, the subroutine can hold no external references, and 
all branching must be short. Although this type of structure is possible in assembly 
language coding, it is severely limiting. 


External Procedures 

If you compile the assembly language subroutine separately, whether you use 
the {$L filename > directive to associate the subroutine with your Pascal program or 
use the two-phase development process of compiling and linking, there usually is 
only one stipulation for interfacing with assembly language subroutines: you must 
use the PROCEDURE statement to define the subroutine name and the variables to be 
passed. The format of this statement is 

PROCEDURE function_name(argl,arg2,arg3, ... ,argn: dtype); EXTERNAL; 

In (his syntax, f.unction_name is the publicly declared name of the assembly 
language subroutine. The arguments (1 through n) are the names of the variables 
whose values or pointers will be passed to the subroutine. For simplicity’s sake, the 
parameters’ data type (dtype) usually is INTEGER. (Although all parameters in die 
example are of the same type, these parameter types can often be mixed; see your 
compiler’s reference manual for details.) 

To indicate that pointers rather than values should be passed, the variable 
names can be modified with var prefixes, var indicates that only the offset address 
of the variable will be passed. 


The Interrupt Attribute 

Beginning with Turbo Pascal 4.0, and under all versions of QuickPascal, you 
can write interrupt procedures in addition to the usual procedures and functions. 
When you choose the inline () technique for associating your assembly language 
module with your Pascal program, you can add the Interrupt; attribute to the 
declaration to specify that this procedure is made suitable for servicing a machine 
interrupt. 

Because it affects only the code generated automatically by the compiler, this 
attribute does not apply to external procedures. You have always had the ability to 
make external procedures suitable for interrupt servicing, however, because you 
must provide all of their code. 
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uses inline) | coding, extra code is generated ° declllril,ion of a procedure that 
point to save all the CPU registers and to rh auto " lat,cal1 )' al ll> e procedure s entry 
your procedure's own data area In add , ^ ‘ hC ° S re8 ' s,cr 50 ,hal '' points to 

by an IBEX, and all registe^a. r'^red ^^eT 1 '"" inStrUC,i °" * 

T C ° dC 8e, ' Cra,ed t0rreSP ° ndS ’° ‘ he f °" OWing W- 1 ‘'Natation: 

i“t ' SVCI Fla ° S ' CS ' IP ’ A)< . B *.CX,DX,SI 1 OI,DS,ES,BP : .ore 
BEGIN 


END; 

wai affect the regfst^upo"^ ret'um^o^h”' parame<m on ,he s,ack ; the changes 
system will be doing af t^nsunt P^^ngwhatfhe 

-ever, hardware 

capable of keeping up with daia rates of 1 200^^^ hi C k m "lr Un,Cat,0nS P* 0 *™ 1 * 


Interfacing Subroutines without 
Variable Passing 


To help you better understand how an a«emkit, i* 
interfaced with Pascal i™tr „ r . assemb, y language subroutine is 

parameter passing. Consider the follol^ ^ 
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Pegs 99.132 
Co a as nt ; 


Flit: CUROFF.ASM 

Author: Alltn L. Wystt 

Date: 8/24/91 

Purpose: Subroutine to turn the cursor off. Designed to be 
called fro* Turbo Pascal 6.9. 

Forest: COROFF() 


I 

I 


curoff 


curoff 


PUBLIC curoff 

.MOOEL swell, Pascal 
• COOE 


PROC 


MOV 

AH, 3 

XOR 

BX,BX 

INT 

19h 

OR 

CH,20h 

MOV 

AH, 1 

INT 

19h 

RET 


ENOP 


END 



; gat currant cursor 


; force to OFF condition 
; set new cursor values 


This short routine turns off the video cursor, using the BIOS functions that first 

gel the current cursor type and then set a new cutao.****“**'£« ** 0 ™- 
off control bit to a value of I by means of the OH CH,2Mt Insttuoioat. A 
omission from both the QuidtPascal and Turbo Pascal libraries Is a method for 
controlling the cursor s visibility, thus, this routine Is not only a simple cample but 
also serves a' useful purpose. 


To Indude Curoff in a program by means of the lnllnaf) facility, ass emb le 
CUROFF.ASM. Then you can use the following Pascal program to.determine the 
bytes you should use in your inline statements: 
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File: 

Author: 

Date: 

Purpose 


.> 

progran Ob]Read; 
uaas Crt; 

var Good, Rpt:Boolean; 

N, Z:Integer; __ 

FileNameiString; 

FptrrLongint; 

Fro«Flle:Byte; 

FN:File of Byte; 

function OpenFile:boolean; 
v ® r Flan, Loop:Integer; 

•Ext:Boolean; 

begin 

^**11® ( Naae of OBJ file to analyze: *); 

Readln (FileNaae); 
if (FileNaae - ") then Halt(i); 

FLen :- Length(FileNaae); 

Ext :• False; 

9 • 

For Loop :• t to Flen do 
begin 

If FileNaae(Loop) ■ then Ext :• True; 
end; 

if not Ext then FileNaae :■ FileNaae ♦ '.OBJ*; 

Assign(FN, FileNaae); 

{»!•> 

*®set(FN); 

{*!♦} 

OpenFile :* IOResult » •; 

,nd (Openfiie); 


OBJREAD.PAS 
Allen L. Wyatt 
8/21/91 

•v 

«. OBJ »u. cr.., M 5y wa, or T 

" «•» MCMMry t. IT 

rizz:.r’ Miy “ 
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function GetByte(var RecNum:Longint) :Byte; 
var Raw:Byte; 
begin 

Seek(FN, RecNum); 

Read(FN, Raw); 

GetByte :*> Raw; 
end (GetByte); 

function HexByte(var X:Byte):String; 
var I, J: Integer; 

Con: String; 
begin 

Con :* ' 01 23456789ABC0EF'; 

I :■ (X Div 16) + 1; 
j :« (X Mod 16) + 1J 
HexByte :* $’^ConlI]+Con|J) 
end (Hex); 

begin 

ClrScr; 

Good :• False; 

while not Good do Good :■ OpenFile; 

Fptr :» B; 

Rpt :■ True; 

while Rpt do 
begin 

FromFile :* GetByte(Fptr); 

Fptr : = Fptr ♦ 1; 
if FromFile <> 160 then 
• begin 

FromFile := GetByte(Fptr); 

Fptr := Fptr ♦ 2 ♦ FromFile; 
end 
else 

Rpt :* False; 

end; 

ClrScr; 

Writeln (Use the following statements in your program:*); 

writeln ( 1 '); 

FromFile := GetByte(Fptr); 

Fptr := Fptr ♦ 5; 
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289 


N Fromrile • 4; 

Z := N Mo<J 0; 
write (' in) ir,e( *); 

" nUe " * ’ 00 U U :>orc final byte; as.um u is SET) 

begin 

if N Mod 5 » 2 then 
begin 

Writeln ( "); 

Write (’ •); 

end; 

FromFile GetByte(Fptr); 

Fptr :* Fptr ♦ 1; 

Write (HexByte(FromFile)); 

N :* N • 1; 

if N > 1 then Write (’/'); 
end; 
writeln 
Close(FN); 
end. 

if you worked through Chapter 11. this program may seem familiar. It provides 
the same function for Turbo Pascal programmers that OBJ READ.BAS provides for 
BASIC programmers. The program works with OBJ files created for assembly 
language subroutines that do not use parameter passing. 

When you run this program and supply the name of the OBJ file (CUROFF). you 
will see the correct inline statements to use in your program. The following shows v 
a Turbo Pascal program with the inline statements in place: 

{ PEX1.PAS } 

{ written by Allen L. Wyatt 
{ Date 8/27/91 ) 

{ Program to test calling of CurOff() > 

procedure CurOff; 

begin 

inline( 

$84/J03/$33/SOB/SCO/ , 

$10/$80/$CD/$20/SB4/ 

$01/$CD/$10); 

end; 
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oegi" 

»"itelnrTn« cursor is now turning OFF'); 

CA*rCf*; 

Hea&n; 

erxJ. 

This program works, but two things are wrong. First, the program is not well 
commented. This may not be a big issue while the program is fresh in your mind, but 
it may be a problem a few weeks or months from now. 

Second, the pro gr am turns off the cursor completely—tt is still off when the 
pr ogr am is done and you return to DOS. Both problems can be solved by taking a 
slightly different approach to including the inline statements in the Turbo Pascal 
program 

If you created a LST file when you assembled CUROFF. ASM, you can use your 
text editor's cut-and-paste facilities to move the hex code bytes from the LST file 
into a Pascal source program. Note how this is done in the following program: 

{ P£X2.pas } 

{ written by Allen L. Wyatt 
{ Date 8/27/91 > 

{ Prcg-a* to test calling of CurOff() > 


procedure CurOff; 

begin 

inline! 


S84/J63/ 

{ MOV 

AH,3 

; get current cursor 

> 

$33/$06/ 

{ xon 

Bx.ex 


> 

$CO/$10/ 

( I NT 

IBh 


> 

$8B/$CD/$2B/ 

1 OR 

CH,20h 

; force to OFF condition > 

$84/Ml/ 

I MOV 

AH, 1 

; set new cursor values 

} 

$CO/$10); 

! I NT 

1th 


> 

end; 





procedure CurOn; 


- 



begin 





Inline! 





$84/$63/ 

< MOV 

AH,3 

; get current cursor 

) 

$33/$06/ 

{ XOft 

BX.BX 


) 

$C0/$1B/ 

{ INT 

iBh 


} 

$80/$E5/$1F/ 

! ANO 

CH.IFh 

; force to ON condition 

> 

$84/$01/ 

! MOV 

AH, 1 

; set new cursor values 

> 

$CO/$10); 

{ INT 

IBh 


) 


end; 
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begin 

writeln(‘The cursor is now turning OFF'); 
CurOff; • 


Readln; 

Writeln('Now going back ON'); 
CurOn; 
end. 


K* ra I!l ,S m “^ h m ° rc re,dable now ’ “ *e original assembly language 
wh ™“ h * vc b “ n ,ndud<:d “comments. Note that I have also included 

only ° nc sa,em<:nl (>»” bytes), so that the test can turn the cursor 
back on before returning to DOS). 

You probably noticed that the final ret statement in the assembly language 
file was K)t included in die inline statements of the Turbo Pascal program. Including 
this statement is not necessary, as it is handled automatically by the Pascal compiler 
and the begin and end keywords thatbracket the procedure definition. 


If you are using any version of Turbo Pascal earlier than 4.0, this technique is 
the on/>- method available for including assembly language in your programs 
Although you can use this method with later versions also, the following option is 
available as well. This program is somewhat simpler to type but requires that you 
asserr.ole your subroutines separately so that OBJ files are available when you 
compile the main program. 


{ PEX3.PAS ) 

{ Written by Allen L. Wyatt 
{ Date 8/27/91 ) 

{ Program to test calling of Cur0ff() ) 

{$L CUR0FF.08J) 
procedure CurOff; external; 


<$L CURON.OBJ) 
procedure CurOn; external; 

begin 

Writeln('The cursor is now turning OFF'); 
CurOff; 

ReadLn; 

Writeln('Now going back ON'); 

CurOn; ~ . 
end. 


When this technique is used, the OBJ files must contain all the program 
statements necessary to protect the stack and return to Pascal properly; the Turbo 

; . . ... . .. 
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..,..,1 compiler (Iocs m« add anything to a procedure defined as esternal. I he only 
'•''cnee in .his .cc Unique and d.a. used by older compilers .ha. requ.rc a separa.e 
Is the presence of .he (SL> compiler direc.ives. The <*L| d.rec.ves cause 
ihc i >11.1 file to be linked in the final program. 

Both CUROFF and CURON were treated as near routines. If you are creating 
routines that are FAR. vou need to use an additional directive in your ur asca 
source file. For instance, if CUROFF and CURON hid been created as FAR routines, the 
Turbo Pascal program would have been changed in the following manner: 


{SL CUROFF.OBJ) 

{SF* procedure CurOff; external{$F-}; 

{SL CURON.OBJ) 

{SF+}procedure CurOn; external{SF•}; 

The SF directives tell Turbo Pascal to switch between NEAR and FAR addressing. 
II the OBI file's are created using far procedures, it is absolutely essential that the 
procedure statements be bracketed In the {SF*} and <SF-) switches. Otherwise, 
although no error will be detected during compilation, the program will cause your 
system to lock up when it executes because ii will not return properly from the first 

such procedure called. 

Notice that there is nothing mystical or magical aboui the way this routine is 
called. The compiler or the linker makes sure that the proper routines are linked to 
create the executable (L'XJ-;> file. Invocation of the assembly language subroutine 
presupposes that the external procedures have been declared in the program 
header Without the procedure statements, an ciror would be generated during the 
compilation process. 


Interfacing Subroutines with 
Variable Passing 

Pascal uses the stack for passing variables to assembly language. Values, short 
pointers, and long pointers can he passed. 

''because the preceding subroutines (CurOff and CurOn) differ in only one 
instruction, combining them into a single routine that can do both jobs is a more 
efficient use of space. You can easily modify the routine so that a flag value specifies 
whether to (urn the cursor off or on The following assembly language program 
includes this modification: 


\ 
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Page 60, 

132 

Comment 

1 

1 

• 

File: 

CURSW.ASM 

Author: 

Allen L. Wyatt 

Date: 

8/27/91 

Purpose: 

i 0 . ,Ur " "" CUr “"' “ or «"■ 

to be called from Turbo Pascal 6.0. 

Format: 

CurSw(0) to turn the cursor off 

CurSw(l) to turn the cursor on 

The variable passed to CurSw() should be an 
integer value. 


PUBLIC CurSw 


.MODEL small, Pascal 
.CODE 


CurSw 

PROC 

NEAR Switch:WORD 



MOV 

AX,Switch 

• 

9 

get flag value 


OR 

AX,AX 

• 

» 

test zero/nonzero 


JNZ 

CS1 


/ 

zero means OFF 


.MOV 

AX,20h 

• 

0 


JMP . 

SHORT CS2 


/ 

CS1: 

MOV 

AX,0 

• 

» 

else turn ON 

CS2: 

PUSH 

AX 

9 

either way, save it 


MOV 

AH,3 

i 

get current cursor 


XOR 

BX,8X 




INT 

10H 




POP 

AX 

• 

• 

retrieve saved control 


AND 

CH,iFh 

i 

clear previous bit 


OR 

CH.AL 

• 

i 

and set in new one 


MOV 

AH, 1 

! 

set new cursor values 


INT 

1CH 




RET 




CurS# 

ENDP 





END 





I 

I 
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Mixed Language Programming with Assembly Language 


This version of the assembly language routine differs ru. eably from iu 
predecessors. CURSW tests an input value and turns the cursor off for zero for on for 

any other value). 

Notice that the variable is passed through the stack as described in Chapter 2, 
-An Overview of Assembly Language " On entry to this routine, Pascal pushes the 
variable’s value on the stack. Because the variable is an integer (it must be declared 
as such in the Pascal program), it can be accessed as a word on the stack. 

This routine is written as a NEAP routine so that it will work properly as a series 

of inline statements in a Turbo Pascal program. You must change the Pascal 
programs that Vise this routine to pass a value. The modified routine using inline 
statements is as follows: 

{ PEX4.PAS ) 

{ Written by Allen L. Wyatt 

< Date 6/27/91 > 

< Program to test calling of CurSwf) ) 

procedure CurSwf switch : integer ); 

begin 

inline( 


$86/546/504/ { 

IIOV 

AX,Switch 

; get flag value 

) 

30B/5C0/ { 

OR 

AX, AX 

; t»St zero/nonzero 

> 

$75/505/ { 

JNZ 

CSI 


> 

508/520/500/ { 

MOV 

AX,20h 

; zero means OFF 

) 

5EB/503/ ( 

JUP 

SHORT CS2 


> 

588/500/500/ { CSi: UOV 

AX, 0 

; else turn ON 

> 

$50/ { CS2: PUSH AX . 

; either way, save it 

> 

584/503/ { 

MOV 

AH,3 

; get current cursor 

} 

533/506/ { 

XOR 

BX,BX 


) 

5CD/510/ { 

INT 

10H 


> 

558/ < 

POP 

AX 

; retrieve saved control ) 

S80/5E5/51F/ { 

ANO 

CH,iFh 

; clear previous bit 

> 

50A/SE8/ { 

OR 

CH.AL 

; and set in new one 

> 

584/501/ < 

MOV 

AH, 1 

; set new cursor values 

> 

5CD/510); < 

INT 

10H 


> 


end; 

begin 

Writeln(‘The cursor is now turning OFF'); 
CurSw(f); 

ReadLn; 

Wrxteln('Now going back ON'); 

CurSw(1); 

end. 
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For the external procedure version, the Pascal program is modified as follows: 
{ PEX5.PAS > 

{ written by Allen L. Wyatt 
{ Date 8/27/91 } 

{ Program to test calling of CurSw() } 

{SL CURSW.OBJ} 

procedure CurSw( switch : integer ); external; 
begin 

Ki|riteln('The cursor is now turning OFF'); 

CurSw(0); 

ReadLn; 

Writeln(‘Now going back ON')'; 

CurSw(1); 
end. 

Notice that only a few modifications are made to the routine. The line that 
declares the procedure uses a name enclosed in parentheses, and the lines that 

invoke the name enclose in parentheses a constant value to control the routine's 
actions. 

Because it fills a void in the provided video-control libraries, the CurSw() 
routine can become a useful item in your Pascal toolbox. 


Passing Variable Pointers 

The preceding routine works well if the variable being passed on the stack is 
a value. But a pointer to a variable wquW cause problems for the assembly language 
subroutine, which is not designed to pass a pointer. 

Why would passing a variable’s address pointer be valuable, as opposed to 
passing oply a value? Because if you know the variables location in memory, you can 
make direct changes to the variable's value in the assembly language subroutine 

This capability can be invaluable if you need to pass information back to the calling 
program. 

One feature notably absent from most Pascal run-time libraries is a capability 
for reading data directly from the screen. To do so, you must pass the data being read 
hack to the calling program One wav of doing this is to use a pointer to a string 
variable that is available also to the calling program. Here's the assembly language 
for such a module, it must be assembled with 1 ASM 3 0. (Note that it is much more 
complex than any example shown so far.) 
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Pag* eg, 132 

Comment ' 


FUtt READSCRN.ASM 

Author: Allen L. Wyett 

Date: 8/27/91 


Purpoee: Subroutine designed to read date directly from 
acreen to Pascal string. 


Format : READSCRN ( ROW,COL, NUM:word;BFfl:string); 

ROW: Row at which to start, 0-24 

oOL: Column at which to start, 9-79 

NUM: number of characters to read, 1 through 80-COL 

BFR : pointer to string where data will be put. . 



PUBLIC 

ReadScrn 


.MODEL 

.CODE 

small, Pascal 

ReadScrn 

PROC 

NEAR Row, Col 


USES 

ES, DX 


LES 

01,Bptr 


MOV 

AH,0Fh 


1NT 

ion 


MOV 

AH,03 


INT 

I0h 


PUSH 

DX 


MOV 

AX,Row 


CMP 

AX, 25 


JAE 

ERROR 


IIOV 

DH.AL 


MOV 

AX,Col 


CMP 

AX, 80 


JB 

OKAY 

ERROR: 

XOR 

AL.AL 


STOSB 

.IMP 

SHORT EXIT 


Num:W0RD, Bptr:DWORD 

;Get string address 

;Get video page in BH 

;Get current cursor location 

;Save xt to restore later 

:Gei row number 

;Too big, get out 
;Okay, set into OH 
;Get col number 

* 

,Not too big so proceed 
;Too big, set string to zero 
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OKAY: 


REAOEIi: 


Rl: 


EXIT: 


REAOSCRN 


MOV 

DL,AL 

PUSH 

OX 

MOV 

AH,2 

INT 

IBh 

POP 

OX 

MOV 

CX,Num 

JCXZ 

ERROR 

MOV 

AX.BB 

SUB 

AX,OX 

CMP 

CX,AX 

JA 

ERROR 

MOV 

AL.CL 

6T0SB 


MOV 

AH,a 

INT 

IBh 

STOSB 


INC 

OL 

CUP 

DL.ee 

JB 

Rl 

INC 

OH 

XOR 

DL.OL 

MOV 

AH,2 

INT 

IBh 

LOOP 

READEM 

POP 

OX 

MOV 

AH,2 

INT 

IBh 

RET 


ENCP 


END 



;Now set in column 
;Store column for liter 
;Change cursor location 

;Get column back 

;Get length of atrlng 

;No length for string, so error 

;Maximum string length 

IAdjust maximum for starting column 

;Is it longer than allowed? 

;Yes, so exit with an error 
;Otherwise, store it as string length 


;Get char from BIOS 

;Put down in string 

;Advance cursor 

;If off end of row, do wrap 

;Still on row, okay 

;Off end, go to next row 

;at column zero 

;Set new cursor location 

;and go back for next 

;Restore original cursor 


In this routine, the calling program passes the row and column where the 
reading action is to begin and the number of characters to be read, as well as a pointer 
to the string variable where the data is to be placed. The assembly language code then 
saves the original cursor position, moves the cursor to the position where the read 
is to begin, and copies characters from the screen to the string until the desired 
number of characters have been read. The routine then restores the original cursor 
position and returns. 


If any of the values passed to the routine ?re outside the limits f the screen, 
no characters are read, and the length of the string is set to zero to indicate that an 
error occurred. 
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To use this routine from Turbo Pascal, enter the following program. Since the 
OBJ filcwould be quite lengthy, converting the file to inline statementsdoesn t make 
much sense. Using the linking directives instead saves time and space. 


{ rdscrn.pas ) 

{ Written by Allen L. Wyatt 
{ oate 8/27/91 ) 

{ Program to test calling of ReadScrnO ' 


program RdScrn; 
uses Crt; 


{$L REAOSCRN.OBJ} 

procedure ReadScrn(Row, Col, Num: 


Integer; var Bfr: String ); external; 


var 

Inputbuf: String; 
r, c, w: Integer; 


begin . • 

Writelnl 'The follow!.., Use wall be read, begibhing with the 5th column:’); 
writeioC This is a test line, to see how many characters will be read ); 

ReadScrn(l,4,20,Inputbuf); 


"ruelnt-TM following are the 2® characters read by the routine:’); 
wnteln(lnputbuf); 

Wnteln( ‘ ‘); 

w/ritelnrRemember that the top left corner is 0,0. ). 

Writelnt ‘To e«it this demo program, enter a row of » and a column of *.’); 


repeat 
R := 90; 
while R > 24 do 
begin 

writer Row: ‘); 
Readln(R); 

end; 

C :* 90; 

while C > 79 do 
begin 

Writa( ’Column: f$ 
Readln(C); 
end; 
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if R*C > © then 
begin 

W := ©; 

while (W < 1) or (w > (80 • C)) do 
begin 

Write(’Width: ’); 

Readln(W); 

end; 

ReadScrn(R,c,W,Inputbuf); 

Writeln(Inputbuf); 

WritelnC ’); 
end; 

until R+C * 0 ; 
end. 

In this test program, the string Inputbuf, declared at the global level, accumu¬ 
lates the data read from the screen. The single word var in the declaration of the 
external procedure, preceding the reference to Inputbuf, is what makes Pascal pass 
the address of the string, rather than the string itself, to the procedure. 

Pointers can also be useful when you work with strings, as vou can see from the 
following program: 

Page 60,132 
Comment ; 


File: ULCASE.ASM for Turbo Assembler 3.0 

Author: Allen L. Wyatt 

Date: 8/27/01 

Purpose: Subroutine designed to convert a string to upper- 

or lowercase. Designed to be called from Turbo Pascal. 

Format: ULCase(S.X) 

S: Pointer to string to be converted 
X: Controls conversion 
• ■ Convert to uppercase 

7 Any other value signifies convert to lowercase 

***••••••••••••••• nteiteiM i 

i 
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PUBLIC 

ULCase 



.tIOOEL 

snail, Pascal 



.CODE 



ULCsse 

PROC 

NEAR Sptr:DWORD, Caae:WR0 


USES 

E8, 01 



LEI 

OI.Bptr 

;Qst string addrass 


INC 

01 

;Point past langth 


IIOV 

AX,Casa 

;0at action variabla 


CMP 

AX.f 

{Converting to upparcasa7 

' 

JZ 

UPPER 

;Vaa, so go handla 

LOWER: 

CMP 

BYTE PTR (OIJ.B 

;is this and of string? 


JE 

EXIT 

;Yas, so exit 


CMP 

BYTE PTR 1011,'A* 

;ls it < A 7 


JB 

LI 

;Yee, eo skip character 


CMP 

BYTE PTR IDII.Z* 

;ls it > Z 7 


JA 

LI 

;Yes, so skip character 


on 

OR 

BYTE PTR (Oil,20h 

;Uake lowercase (OBiBBBBBb) 

LI: 

INC 

01 

;Next character 


JMP 

LOWER 

;Do it again 

UPPER: 

CMP 

BYTE PTR (01).• 

;Is this end of string? 


JE 

EXIT 

;Yes, so exit 



BYTE PTR (OIJ,'S* 

;Is it < a 7 


JB 

Ul 

;Yes, so skip character 


CMP 

BYTE PTR (OII.'Z* 

;ls it > z 7 


JA 

Ul 

;Yes, so skip character 


is* ■ 

AND 

BYTE PTR [0I],B5Fh 

{Make uppercase (BiBililib) 

Ul: 

INC 

01 

{Next character 


JMP 

UPPER 

;Do it again 

EXIT: 

RET 

- 

• 

ULCsss 

ENOP 




END 




Thi» simple program, which convcru a string to either all upper- or all 
lowercase, expects two parameters to be passed from Pascal: a pointer to the string 
to be convened, and an integer value indicating whether the string is to be converted 
to upper* or lowercase. 
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« rin ^«co„?ct^rn^ u ta^‘ h ‘ he COnV ' ra ‘° n prOCC “ *+" « ">c 

.rtng vahable alway, contain. the number ^^Z^,^ 0,iU0n * * 
The Pascal program that will use (his subroutine follows: 


{ TE8TCA8E.PA8 ) 

{ Written by Allen L. Wyatt 
{ Olti 0/27/01 > 

{ Program to teat calling of ULCaee() y 


prograa TaatCaaa; 
uaaa Crt; 


var 

•: String; 


<SL ULCA8E.0BJ) 

procedure ULCaaa(var erString; xrlnteger); external; 

begin 

Clr8cr; 

••“’Original etrlng value'; 

While length(s)>0 do 
begin 

, Write('String to convert: •); 

Atadln(e); 

If length<e)>0 then 
begin 

Wrlteln(‘UPPERCASE: ') ; 

Wrlteln(e); 

* Wrlteln(' 

Wrltoln('lowercase: *); 

ULCaao(o,i); 

»rlteln(0); 

Wrlteln("); 

and; 
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Using Function Subprograms 

^en you want an assembly 

££S^;t-w; 

the calling program. 

To return a value, your assembly language routine must be declared as a 

function rather than t procedure, and the type of value the.Zs ^Se^Tp^fy 
be specified. Then, in the routine, you can use the new RETURNS modifier to spealy 

the value to be returned to the calling program. 

The following assembly language program for a 
READSCRN ASM shows the differences between using a pointer and creating 

function. Again, it should be assembled with TASM 3.0. 

Page 60,132 


Comment ! 


File: ’ RSFUNC.ASM 

Author: Allen L. Wyatt 

Date: 8/27/91 


Purpose: Subroutine designed to read data directly from 
screen to Pascal string. 

Format: READSCRN (ROW, COL, NW: word): string); 

ROW: Row at which tp start, 0*24 

COL: Column at which to start, 0-79 

NUM: number of characters to read, 1 through 89 -COL 



PUBLIC 

RSFunc 


.UOOEL 

.CODE 

small* Pascal 

RSFunc 

PROC 

NEAR ROW, Col, Nun:WORD RETURNS Bptr:DWORD 


USES 

ES, DI 


LES 

Dl.Bptr ;Get return value address 


Scanned by CamScanner 





Chapter 12: Interfacing with Pascal 


ERROR: 


OKAY: 


READS!: 


Rl: 


MOV 

AH,0Fh 

INT 

10h 

MOV 

AH ,03 

INT 

10h 

PUSH 

OX 

MOV 

AX,Row 

CMP 

AX,25 

JAE 

ERROR 

MOV 

dh.al 

MOV 

AX,Col 

CMP 

AX,80 

JB 

OKAY 

XOR 

al,al 

STOSB 

JMP 

SHORT EXIT 

MOV 

OL.AL 

PUSH 

OX 

MOV 

AH,2 

INT 

10h 

POP 

OX 

MOV 

CX,Num 

JCXZ 

ERROR 

MOV 

AX,80 

SUB 

AX,DX 

CMP 

CX.AX 

JA 

ERROR 

MOV 

AL.CL 

STOSB 

udv 

AH,8 

INT 

10h 

STOSB 

INC 

OL 

CMP 

OL ,80 

JB 

Rl 

INC 

OH 

XOR 

dl,dl 

MOV 

AH,2 

INT 

I0h 

LOOP 

REAOEM 


;Get video page in BH 


,'Oet current cursor location 

;Save it to restore later 

;Get row number 

;Too big, get out 
.'Okay, set into DH 
;Get col number 

;Not too big so proceed 
’Too bi S. set retval to zero 


;Now set in column 
;Store column for later 
;and change cursor location 

;Get column back 
;Get length of retval 

;No length for string, so error 
;Maximum string length 

;Adjust maximum for starting column 
;Is it longer than allowed? 

;Yes, so exit with an error 
;and store it as string length 


;Get char from BIOS 

.Put down in retval 
;Advance cursor' 

»If end of row, do wrap 
»Still on row, okay 
»Off end, go to next row 
»At column zero 
.Set new cursor location 

;and go back for next 
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;R»ttor« original curtor 


EXIT: 


RSFonc 


POP 

OX 

MOV 

AH,2 

INT 

I9h 

RET 


ENDP 


ENO 

* 


;Leave temp pointar on stackl 


To use this function veoion, the P«cal P~gnun mu*t be ranged aomwtat. 
as follows^ 

{ RSFUNC.PAS } 

{ written by Allan L. Wyatt 
{ Date 8/27/91 ) 

( p r0 grM to toat calling of BSFuncO ) 

program RSFoncTett; 
uses Crt; 

!!icu.n M^nc(««, Col, Nun: Intog.r): String; a.t.rnal; 


var 

X: String; 

r, c, w: Integer; 

. , . . ’■y * 

begin 

ClrScr; b# rfad| beginning with the 5th column:*); 

.«.«u».«...—-»*•"•**• * ai *• r,,d,,i 

X :■ RSFunc(1, 4, 29); 

ESSrm following ar. th. a. .har.ct.ra raad by tn. r^tln.:-,; 
Writeln(X); 

zszzzrxz . »i«.. 

repeat 
R :• 99; 

while R > 24 do 
begin 

WriteCRow: ’); 

Readln(R); 
end; 
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C := 90; 

while C > 79 do 

begin 

write( 'Column: ); 

Readlrt(C), 
end; 

if R*C > 0 then 
begin 

W ;• 0; 

while (W < i) or (W > (80 • C)) do 

begin 

Write('Width: •); 

Readln(W); 

end; 

X :« RSFunc(R,C,W); 

Writeln(X); 

Writeln(•*); 
end; 

until R*C * 0; 
end 

Notice that the external declaration, which is for a function rather than a 
procedure, does not mention the string pointer. A type declaration follows the 
closing parenthesis of the external declaration 

The major difference in the program is that RSFunc( ) is invoked by assigning 
its value to a string variable instead of just calling it by name Not having to include 
the buffer name as a parameter to each call clarifies the program’s operation a bit. 
however-, this way. all the parameters are information passed into the routine. 


Summary 

Pascal is a popular language among many programmers. The ease with which 
you can combine assembly language subroutines with Pascal programs depends, 
however, on the way you use your Pascal compiler. 

Until Turbo Pascal version 4.0 became available, only the high-powered 
“professional" Pascal compilers that required a separate linking phase were easy to 
augment with assembly language modules. Turbo Pascal now offers a choice of 
several simple interfacing methods, however. 

No matter which method you choose, you will find th.ii rhe performance of 
your Pascal programs can be improved significantly if vou make the small effort 
necessary for mastering the assembly language interface. 
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Part II: Mixed Language Programming with Assembly Language 
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CHAPTER 


13 


Interfacing with C 

and <C+ + 



P ™ dC+ , + uc two °^ l ^ e fastest-growinghigh-level languages available, in terms 
V-i of market share. It has been said that ovei 75 percent of all commercial 
progi ams for personal computers are written in C—quite a plaudit for the popularity 
of the language. And C + + Is gaining in popularity because of its object-oriented 
nature and the release of Borland’s C+ + products. 

Why are these languages so popular? Although the reasons vary- from program¬ 
mer to programmer, for most people C seems to provide the right mix of ease of use, 
access t^ system-level functions, and transportability. C++ provides not only the full 
benefits of C. but also the flexibility of objects. These benefits combine to make cither 
language attractive for development. 

Eventually, most serious C or C++ programmers must face the task of 
interfacing assembly language subroutines with the language. Because C and C+ + 
are compiled languages, assembly language subroutines can be linked as the final 
step in program development. The trick is to make sure that the interface between 
assembly language and C or C++ is followed strictly, to allow proper passage of 
variables. Since C++ is an evolutionary step of the C language, the Interface between 

C+ + and assembly language is Identical to the interface between C and assembly 
language. 7 

The popularity of C compilers comes and goes, and it is probable that C+ + 
compilers will follow this same cycle. In recent years, several C compilers (Including 
Microsoft C, Lattice C, Aztec C, and Turbo C) have been popular. The list of C+ + 
compilers has been more rarifled; the most notable are Turbo C+ + (and the variant 


307 
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Borland C+ + ) and Zoned. C+ + . In the C arena, most ol the popular com- 
oilers have similar functions and implementations of the language C + + compilers 
are somewhat more disparate, but not completely incompatible. Any notable 
differences between versions are mentioned as the examples in this chapter are 

developed. 

Watching what Borland is doing in the area of object-oriented programming, 
as exemplified in their C++ compilers, is particularly interesting. In the latest 
version of TASM, Borland has even brought object-oriented programming to 
assembly language. Such a move, unthinkable a few' years ago. seems to be the 
direction in which Borland wants to lead the market. It will be interesting to sec what 
happens in the coming years. 

Because the object-oriented applications of assembly language are brand new 
and have no wide-spread practical use as of this writing, their specific development 
is not covered here. Rather, this chapter focuses on general-purpose assembly 
language routines that can easily be interfaced with any version of cither C or C + +. 
Thus, references to C in this chapter can be assumed to apply to C+ + as well. 


Memory Models 

Before any general guidelines for interfacing with C programs can be devel¬ 
oped. memory models must be discussed because they have significant impact on 
all guidelines. 

Chapter 1 discussed how the Intel CPU chip design forces memory manage¬ 
ment to be done in segments and how each segment can address a maximum of 
65.636 (64 K) bytes. That’s the basis of the memory model concept; it simply specifies 
how the segments are to be managed. 

Originally. C compilers for MS-DOS addressed only one memory model, the 
one now known as small /Ml code procedures shared a single 6 iK-moximum code 
segment and all daia had to fit into another Gak-mxximum data segment. Program¬ 
mers found this far too limiting, however, and today's compilers support four to six 
memory models. The usual definitions for these models are listed in table 131. 

The tiny model may be familiar to you as the format used by COM files in which 
data. code, and stack must all fit into a single 64 K segment The small model breaks 
code and data into separate segments of 6-*K each. In both of these models, all 
pointers for both procedures and data are NEAR. 

In the medium model each separate module of code has its own segment and 
each may be as many as 6-»K. but all data is confined to a single segment In thi*> 
model, procedure poimeis usually are FAR but data pointers remain near 
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Table 1J.J. Mentor)' model definitions. 

Moiicl 

Coiic Segments 

Data Segments 


Tiny 

One. also containing data 

Shared with code 


Small 

One for all procedures 

One for all data 


Medium 

Many 

One 


Compact 

One 

Many 


Large 

Many 

Many (64 K static) 


Huge 

Many 

Many (>64K static) 



The reverse of the medium model is the compact model, where each major 
data structure has its own segment, hut code is all contained within 6-iK; pointers 
arc NEAR and data poiniers are FAR. This model is seldom encountered. 

The targe model uses FAR pointers for both code and data, although it still 
confines static data storage to 64K. This model often is used when dealing with 
complex systems of programs; it combines the advantages of the medium and 
compact models. 

Finally, the huge model removes the 6-4 K limit on static data and enables a 
single data structure to span more than one segment. When you use the huge model, 
internal address calculations rapidly become complicated; therefore, you should 
avoid using this model unless it is necessary for writing your program. 

Most C programs are written using cither the small or the large memory 
models. Most C and C+ + compilers are configured for the small model by default, 
but their options can be changed to default to any desired model. When you use 
these compilers' command-line versions rather than the integrated development 
environments, the desired model is sclecred by an option switch. 


General Interface Guidelines 

There are two w^ys to interface with C or C + + The easier method is to specify 
a language, using the new simplified model directives for the xssemblers. This 
feature is available with both MASM and TASM. The older and somewhat more 
arcane method is to do manually what is now done automatically by the simplified 

directives. To give you a firm footing in how interfacing occurs. I'll discuss this older 
method f.rst 
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To Interface assembly language subroutine* with C or C + +. you must follow 
a few general guideline* First, you must give a specific segment ru/ne to the code 
segment of your assembly language subroutine. The name varies, depending on 
which compiler you use. For example. Microsoft C, QuickC, and Turbo C require 
either the segment name .text (for tiny, small, or compact memory-model pro¬ 
gram*. Microsoft C docs not support the tiny model) or a segment name c 

suffix .TfXT (for other memory models). Aztec C requires the segment name COOCSEQ. 


Second, your C compiler may require specific names for data segments (i the 
data Is being referenced outside the code segment). Microsoft C, QuickC, and Turbo 
C require that the segment be named .data, whereas you must use the segment name 
DATA6E0 with Aztec C. You must use these segmenf names, which are specific to , 
to properly link and then execute the programs. 


Third, you must .understand how variables are passed to assembly language 
subroutines through the stack. In the function-callirigsyntax of 


function_nsms(srgi ,§rg2,arg3 ,... ,argn); 

the values of each argument are pushed on the stack in reverse order. Thus, 
argument n (argn) is pushed on the stack first, and argument 1 (srgl) is pushed last. 
A value, or a pointer to a variable, can be passed on the stack. Although most values 
and pointers are passed as word-length stack elements, the longer data elements 
such as long or unsigned long-type variables require 32 bits (2 words) of stack space. 

If the memory model being used Is compact, large, or huge, or If the data Item 
has a segment override, data pointers also require 32 blrs of stack space. Float-type 
variables use 6-4 bits (4 words) of stack space. Remember this distinction of stack 
usage by variable type; failure to do so can produce undeslred results. 

Fourth. In the assembly language source flle.-tbe assembly language routines 
to be called from C must begin (for Microsoft C, QuickC, or Turbo C If using its 
default options) or end (for Aztec Q with an underline character. The underline Is 
no: included when the routines arc invoked In C. however. The examples In this 
chapter reflect this distinction; Turbo C's option for this (the underscore) was left 
set at its default ON condition to obtain maximum compatibility In the code while 
testing, but can be set to off If you want to eliminate the need for the underline 

prefix. 

Fifth, remember to save any special-purpose registers (such as CS. DS. 5S, BP, 
SI. anti Dl) your assembly language subroutine may disturb. Failure to save them may 
have uiuleslrcd consequences when control is returned to the C program. Saving 
registers Is especially Important with Turbo C because Turbo C defaults to the 
automatic use of register variables. You do not have to save the contents of AX, BX, 
CX. or I)X because these registers arc considered to be volatile by C; that is, the 
language assumes that you will change them and even requires yog to do so in order 


to return a value. 
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The examples in this chapter were designed to work with C compilers from 
Microsoft and Borland, or C+ + compilers from Borland. If you are using another 
compiler, the only differences you need to deal with should be in the required 
segment names for code and data or in the naming of the subroutines. 


Simpler Interfacing 

Over the years, assemblers have evolved to the point where the interface to 
high-level languages is quite well developed. In earlier chapters in this book, you 
may have noticed this with the use of the simplified model directives that enable you 
to specify the language type you are interfacing with. For instance, you can specify 
C (your programs will also work with C++); then the assembler automatically takes 
care of such issues as Aether to use NEAR or FAR pointers, what segment names to 
use, how to access variables on the sock, and whether to use a leading underscore 
on labels. 

For instance, the following is. a sample (from a program used in the next 
section) of the correct assembly language coding, using the older interfacing . 
methods: 

PUBLIC _CURON,_CUROFF 

_TEXT SEGMENT WORD PUBLIC *COOE' 

ASSUME CS:_TEXT 

_CURON PROC NEAR J for S*all model 

If you use the newer simplified directives, this same information is ».oJed as 
follows: 

PUBLIC CUROfl, CUROFF 

.MOOEL small, C 
.CODE 
CURON PROC 

This source code is much cleaner and easier to read. The directives .MODEL and 
. CODE instruct the assembler to make the necessary assumptions and adjustments so 
that the routine will work with a small-model C program. The assembler also adds 
the necessary underscores before the label names. 

Which method you use to write your assembly language programs is up to 
you. Either works well, and both result in basically the same code being generated 

by the assembler. 
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Interfacing Subroutines 
with No Variable Passing 

To help you understand how an assembly language subroutine is interfaced 
with C. let's look at a sample subroutine that requires no parameter passing. 
Consider the following assembly language program: 

Page 69,132 
Comment | 


File: CEXi.ASM 

Author: -Allen l. Wyatt 

Date: 8/26/91 

Purpose: Subroutine designed to turn the cursor on and off. 

Format: CurOn() 

CurOffO 


PUBLIC CurOn, CurOff 


.MODEL small, C 
.CODE 


CurOn 

PROC 




MOV 

AH, 3 

; get current cursor 


XOR 

BX.BX 

* 


INT 

10h 



AND 

CH.IFh 

; force to ON condition 


MOV 

AH, 1 

; set new cursor values , 


INT 

I0h 



RET 



CurOn 

ENOP 



CurOff 

ROC 




MOV 

AH,3 

, get current cursor 


XOR 

BX.BX 



INT 

ieh 



OR 

CH,20h 

; fc ce to OFF condition 
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; set new cursor values 


RET 

CurOff ENDP 


the example, both procedures hl m? h f ° m < r hapl<:r 12; nolc ,haI in * h *s version of 
oncODJ file is necessary. This is possible''!Jouse mos?C Si " El<: ASM h filC " ' h: " °" ly 

method 6 * "“" S °'°*> 

more difficlk ® W ‘ <h “ 5Cmb ' y modulcs mal * manipulation 

The C program to test this routine is .ns follows: 

/* File: CEX1S.C 

* Author: Allen i. Wyatt 

* Oate: e/26/91 

•^Purpose: Example of using curont) and curoff() 

^include <stdio.h> 


void CurOn(void); 
void CurOff(void); 

void nain() 

{ printf( **s\n*, ‘The cursor is now turning OFF*)- 
CurOff (); 

getchar(); 

printf( *%s\n*, *Now going back ON*); 

CurOn(); 

} 

and uyrtlein ou| lVC 3S5Cmb,cd and com P‘ ,ed lhcse examples, link them together 

haw ^ lhC ° ,dCr mCth0d of incerfacin 8 10 assembly language been used, it would 
unrW to make sure ^at Curon and CurOff were preceded by 

rrr ( v r °" and - C “ r0,, > •» »* ‘“""bly language source file. If you 
choose to use this older method, remembering the leading underscore is critical. 
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Part I! LM&jW J-''* 

Using QuickAssembier with QuickC 

You can create this entire progr.m^thcASMandC nion 

leaving ^integrated development eovronment. 

2.51 (Which includes QuickAsscmb c ). . comb ination- To make 

The program was tested assembler, the compiler, and 

everything wor e, the option f °”“ to off all debugging options 

the linker) had to be modified. The key g^ injenJ i,ive to case. This was 

««^c:-S«.l 0 uses all-uppercase procedure names, whereas the 
c program uses mixed-case names. 

Using Inline ASM Coding with 
Borland C or C + + Products 

If you use Turbo C. 

assembly language routines as inline St restrictions, however, this is 

Turbo Pascal. Because doing r ous C urOn<. /CurOf f () example 

/• Filet • CEX2S.C v 

• Author: Allen L. Wyatt 

• Date: 8/29/91 

• Purpose: example of using curonO and curoffO 


#include <stdio.h> 

void CurOn() 

{ asm MOV AH,3; 
asm XOR BX.BX; 
asm INT 0x10; 
asm AND CH.OxlF 
asm MOV AH,1; 
asm INT exie; 


/• get current cursor / 

I * force to ON condition / 
/• set »«ew cursor values •/ 
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void CurOff() 

{ asm MOV AH, 3; 
asm XOR BX.BX; 
asm INT 0x10; 
asm OR CH,0x20; 
asm MOV AH,1; 
asm INT 0x10; 

> 


/* Qet current cursor 


/ force to OFF condition •/ 
/* set new cursor values •/ 


void main() 

‘ C'flui' 5 '"'' ' Th * eur,,,r “ now ,urnl "« 0FF ’li 

getchar(); 

printf( %a\n‘, *Now going back ON*); 

CurOn(); 

) 

. A Th * e3am P ,e,snam edCEX2S.C;lfyou are usingTurbo C+ +or Borland C+ + 

reqU,r ' :S thl ' av ^ rs,onofC0 « M Contained In Borland', 

wa ho ™ u^ c e ^ B rrr P ^t,r monr modei in use *“ 

About the only advantage you gain by using this inline capability is that the 
program Itself needs no changes if you decide to switch from one memory model to 
another. The CO’.OBj (lie for the desired memory model must cxist howeveT 

£emWv^° d ' S C/C ;+ Pr0duc “ « the «»»P«ers tl,a, s“ PP o„ Mne 
y language, and this support adds several layers of tinni;** 

much eash-'r fi " d ' ha ' d0i " B eve(y,hin 6 throu 8 h 0B -> «« link-time incTusitT^ 


Interfacing Subroutines 
with Variable Passing 


As you probably remember from the discussions earlier in this 
Chapter 10, variables are passed on the stack in C and C++. This 
niethod of variable passing. 


chapter and in 
•s the normal 
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II: Mixed i antmagc Programming xvith Assembly \*n guage 


You can easily combine the preceding subroutines and eliminate much of the 
extensive ^plication of code by passing a variable that specifies whether to turn 
the cursor on or off. The following assembly language program includes this 

modification: 


Page 61,132 

Comment { 


File: CEX3.ASM 

Author: Allen L. Wyatt 

Date: 9/17/91 

Purpose: Subroutine designed to turn the cursor on and off by 
passing a variable on the stack. 

Format: void CurSw(integer switch) 

switch * 0; turn cursor off 
switch <> 0: turn cursor on 



PUBLIC 

CurSw 



.MODEL 

small, C * 



.CODE 



Curb./ 

PROC 

Switch:WORD 



MOV 

AX,Switch 

1 


OR 

AX,AX 

• 


JNZ 

CS1 



MOV 

AX, 20h 

1 


JMP 

SHORT CS2 


CS1: 

MOV 

AX , 0 

» 

CS2: 

PUSH 

AX 

1 


MOV 

AH, 3 

9 


XOR 

BX.BX 



INT 

10H 



POP 

AX 



ANO 

CH.lFh 



OR 

CH.AL 



MOV 

AH, 1 





get flag value 
test zero/nonzero 

zero means OFF 

else turn ON 
either way, save it 
get current cursor 

retrieve saved control 
clear previous bit 
and set in new one 
set new cursor values 
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INT 10H 
RET 

CurSw ENOP 


END 


rhantoranH ^ri!^ var * a ^ c * s passed through the stack, as described earlier in this 
■hr v! rW n < ' ha,>1 1 ! :r 2 - l)n cm, > “> 'hi- rouiine, t pushes Hie variable s valm on 
f ® ccause ' he 'ariable is an integer (it must he declared as such in the 

program), it can be accessed as a word on the stack. 


The C program that uses this routine xvas also changcJ to pass a value. The 
modified routine (based on the previous example, CLX2S.C) follows: 

/* File: CEX3S.C 

* Author: Allen l. Wyatt 

• Date: 9/17/91 


* Purpose: Example of using CurSw() 

*/ 


^include <stdio.h> 
void CurSw( int ); 
void main() 

( printf( *\s\n*, ’The cursor is now turning OFF*); 

CurSw(C); 
getchar(); 

printf( *%s\n’, *Now going back ON*); 

CurSw(l); 

) 

Notice that both the prototype and the invocations of the function now include 
material enclosed in parentheses. The prototype declaration specifics that the 
parameter passed must be an integer, and the invocations specify integer constant 
values: 0 to turn the cursor off and 1 to turn it back on. 

When you are developing from the integrated environments of QuickC and 
Turbo C, certain tricks are necessary to force the linker to consider the assembler 
module s OBJ file. Both tricks are based on the idea of the M/MCE file (discussed in 
detail in Chapter 12). 

In QuickC, you must add the OBJ file by name to the program list for your 
C file, using the MAKF. menu (if you have not already established a program list, von 
musi do so first from the same menu). The MAKF file that drives the link process is 
generated automatically from this program list. 
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In Tuftoo C you must create a PRJ file for your program. This Is merely a text 
file that lists names of the flies to be included. For the previous example. CEX3.PIU 

contained 

cex3s 

cex3.obJ 

The file extension is not necessary for a C source file but is required for OBJ or LIB 
files. The PRJ file can be created by any text editor and should bear the file name you 
want assigned to the final EXE file, with the extension Piy. 


Passing Variable Pointers 

Simply passing Information Into your assembly language routines is not always 
enough—you need to be able to get data back from them as well. Unlike Pascal and 
BASIC, C keeps the calling program in full control of things; thus, one of the standard 
techniques for returning information is to pass in a pointer that contains the address 
of a storage area in the main program. 


Returning Data via Pointers 

To understand how pointers are handled, consider first this assembly language 
program, which was designed to read a specified number of characters from the 
screen: 

Page 60,132 
Comment J 


File: CEX4.ASM 

Author: Allen L. Wyatt 

Oate: 9/17/91 

Purpose: Subroutine designed to read data directly from the 

screen to a C char array. 

t ^ • % 

Format: void ReadScrn(unsigned ROW, 

unsigned COL, 

„ unsigned NUM, 

char • BFfi); 

ROW: Row at which to start, §24 
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COL: Column at which to start, 0-79 
NUM: number of character? to read, 1*255 
BFR: pointer to array where data will be put.. 


1 

PUBLIC ReadScrn 

.MODEL amall, c 
• COOE 

ReadScrn PROC USES ES DI, Row, Col, Num, BFR:WORD 


PUSH 

OS 

*1 

POP 

ES 


MOV' 

01,BFR 

;Get string address 

MOV 

AH,0Fh * 

;Oet video page in BH 

INT 

I0h 


MOV 

AH,03 

;Get current cursor location 

INT 

10h 

, 

PUSH 

OX 

;Save it to restore later 

MOV 

AX,Row 

;Get row number 

CMP 

AX,25 


JAE 

Exit 

;Too big, get out 

MOV 

OH,AL 

IOkay, set into OH 

MOV 

AX,Col 

;Get col number 

CMP 

AX,80 

. 

JAE 

Exit 

;Too big, get out 

MOV 

DL,AL 

;0kay, so set column 

PUSH 

OX 

;Store column for later 

MOV 

AH,2 

isnd change cursor location 

INT 

10h 

• 

POP 

OX 

;Get column back 

MOV 

CX.Nua 

;Get length of string 

JCX2 

Exit 

;No length, get out 

MOV 

AX, 8 $ 

;Maximum string length s 

SUB 

AX.DX 

; Ad just maximum for starting' column 

CMP 

CX,AX 

;Is it longer than allowed? 

JA 

Exit 

iYes, so get out 
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Part 


... language Programming with Assembly Unguag^ 


READEM: 

MOV 

ah,8 

;Get char fro* BIOS 


INT 

10h 



STOSB 


;Put down in string 


INC 

DL 

;Advance cursor 


CMP 

DL.ee 

jif off end of row, do wrap 


JB 

R1 

;St ill on row, okay 


INC 

DH 

;0ff end, go to next row 


XOR 

DL.DL 

;at coluan zero 

R1: 

MOV 

AH,2 

;$et new cursor location 


INT 

ieh 



LOOP 

READEM 

;and go back for next 

Exit: 

XOR 

AL,AL 

;Merk end of string 


STOSB 




POP 

DX 

;Restore original cursor 


MOV 

AH,2 



INT 

10h 



RET 



ReadScrn 

ENDP 




END 




This routine is the C version of the one, described in the last chapter, for use 
with Pascal. Comparing the two to see what changes were required is instructive. The 
biggest change results from the way that Pascal and C store strings—Pascal requires 
the first byte of the stored string to be the length, whereas C requires only that the 
ending byte to be a null (0). 

The following program demonstrates how ReadScrn() can be used: 


/• File: CEX4S.C 

• Author: Allen L. Wyatt 

• Date: 9/17/91 


* Purpose: Example of using ReadScrn() 
•/ 


#include <»tdio.h> 


void ReadScrn( int r, int c, int w, char * b ); 
void ClrHoM(); 

char Buf[81); 
int r, c, w; 
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void. aaln() 

{ ClrMoweO; 

printf('The following line will bo read, beginning with the 5th column:\n*); 
printf('****Thia le a teat line, to see how many characters will be read\n*); 
R«adScrn(1,4,20,&Buf[0]); 

printfC\nThe following la the 20 charctera read by the routine\n%s\n*,Buf); 

printf('VnRemember that the top left corner is e,0.\n'); 

printf('To exit this demo program, enter a row of 0 and a column of 0.\n'); 

do 

{ P » 90; 
do 

< printf(’Row: '); 

acanf( '%d', &r ); 

) while (r > 24); 

c ■ 90 ; 
do 

{ printf('Column: '); 

scanf( *%d', &c ); 

} while (c >79); 

if t(r ♦ c) > 0) 

do 

{ printf('Width: '); 
scant ( *VT , &w ); 

) while ((w < 1) J! (w > (80 • c))); 

ReadScrn(r,c,w,&Buf[0]); 
printf C%s\n\n',Buf); 

> 

) while (r+c !■ 0); 

) 

Notice that another external function is in this program—one that clear* the 
screen and homes the cursor through the use of the ClrHome function. The listing for 
this function is as follows: 
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Page 60,132 
Comment ! 


File: CLRHOME.ASM 

Author: Allen L. Wyatt 

Date: 9/17/91 


Purpose: Subroutine designed to clear the screen and home the 
cursor. Works with C. 

Format: ClrHomeO 

..•.•••• tttttttttttttt ******************* 1 

•••••••••••••••••••• i 


PUBLIC ClrHome 

.MODEL small, C 
.CODE 

ClrHome PROC 


MOV 

AH,0Fh 

;0iscover display state 

INT 

lOh 


PUSH 

AX 

;Save mode/width 

PUSH 

BX 

;Save page 

MOV 

DX,0 

‘.Position 0,0 

MOV 

AH, 2 

;Set cursor position 

INT 

10h 


POP 

BX 

;6et back page 

POP 

AX 

;Get back mode/width 

MOV 

CX,0 

;Upper left is 0,0 

MOV 

DH.24 

;Bottom row 

MOV 

DL,AH 

I Set column width 

DEC 

OL 

'.Actual column number 

MOV 

BH,07h 

;Attribute 

MOV 

AL.DH 

;Lines to scroll 

INC 

AL 

;Full screen 

MOV 

AH,6 

;Scroll window up 

INT 

I0h 



RET 

ClrHome ENDP 
END 
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to read Th f «l! f °‘ y ° U ^ Xskcd f ° r the wid,h of ,hc strin K you want 

continue* tji 8 * ut,fu ^ 1X341 and ,hcn displayed from inside C. The procedure 
com,nu« until you enter . row ofO and a column of 0, a, which time ^program 

used wh'hn'.h^'fc^ example 15 a biI •ImplWc In practice. BeadScrnl) would be 

h° r ^ mpk “ m ° usc d " w PO-on the mouse 
Ihe data H / ,hc Scn -' cn ' and ,hcn a c'ickof the left button would cause 
Z il l IO be ‘° pied by Rea0Scrn( 1 inI ° a b ^r f-um which a later dick of 
Xr C ° 5 ' Ufr the da,:1 im ° ' hC kC > Wd bufftr “ *™la.ed key- 


Using Pointers to Process Strings 

Another reason to pass a pointer to a variable's address instead of simply 
passing the value is that if you know the variable’s location in memory, you can 

tein^u^r/ll, ” lue in yOUr asscmbl )' Idhguage subroutine. This capability can 
be invaluable when you are working with strings, as in the following example: 

Page 60,132 
Comment ! 


File: ULCASEC .ASM for MASM 6.0 

Author: Allen L. Wyatt 

Oate: 9/25/91 


Purpose: 


Format: 


Subroutine designed to convert a string to upper* or 
lowercase. Oesigned to be called from C. 

ULCase(s.x) 

a: Pointer to string to be converted 
x: Controls conversion 
• ■ Convert to uppercase 

7 Any other value signifies convert to lowercase 
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PUBLIC 


ULCSBO 



.MODEL 

small' 0 



.CODE 



ULCass 

PROC 

USES 08 DX' 8ptr f Csss: WORD 


MOV 

Dl'Sptr 

;0et string addrsss 


MOV 

AX.Cast 

;Gst action variable 

• 

CMP 

AX'O 

{Converting to uppercase? 


JZ 

UPPER 

;Ves, so go handle 

LOWER: 

CMP 

BYTE PTR (Dll'f 

;Xe this end of string? 


JE 

EXIT 

;Yes, so exit 

. 

CMP 

BYTE PTR (Dll,'A* 

;Is it < A 7 


JB 

LI 

;Yes, so skip character 


CMP 

BYTE PTR COIJ,*2* 

;Xs it > Z ? 


JA 

LI 

;Yes, so skip character 


OR 

BYTE PTR (DIl'20h 

;Make lowercase (001000Mb) 

Li: 

I VC 

DX 

{Next character 


JMP 

LOWER 

{Do it again 

UPPER: 

CMP 

BYTE PTR (OIl'B 

;Xs this end of string? 


JE 

EXIT 

;Yes, so exit 


CMP 

BYTE PTR (DI] t ‘S' 

;Xs it < a ? 


JB 

UI 

;Yes, so skip character 


CMP 

BYTE PTR (01),'«* 

;ls it > z ? 


JA 

UI 

;Yee, so skip character 


AMO 

BYTE PTR (DIJ'WFh 

{Make uppercase (Oioimib) 

Ui: 

r.c 

01 

{Next charsoter 


JM? 

UPPER 

{Do it again 

EXIT: 

RET 



ULCase 

ENDP 




END 




This simple program converts a airing to all upper- or all lowercase. The 
program expects two parameters to be passed from C: a pointer to the string to be 
converted and an Integer value Indicating whether the string Is to be converted to 

upper- or lowercase. 

Notice the calling syntax for the subroutine: ULCase(s,x). Unlike some other 
l.in C places the function parameters onto the stack In reverse order, from 

right to left Thus, the first Item pushed Is ti)e value for x and the second Itempushed 

is the pointer to s. 
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The C program chat uses this subroutine follows. 
/• File: CEX58.C 

• Author: Allen L. wyett 

• Oete: 9/25/91 

• Purpose: Example of using ULCssso 

Finclude <stdio.h> 

Finclude <etring.h> 

void tlciMi <Mr •. in« /. , UBetlon prototyp , 

unaignad char a(|.-Thla i, tha origin.) atring-; 
void oaln() 

< while (strlen(s) i» 9) 

{ prlntf(‘String to convert: *); 

9ets(s); 

if (etrlen(s) |» e) 

{ prlntf('\nUPPERCASE:\n'); 
ulcese(s.O); 

printfC %s\nlowercase:\n‘,s); 

ulcese(e.i); 

printfC %s\n\n*,e); 

> 

) 

> 


Summary 


interfaced Uni , U ;?V 0 Whkh “**"** •“«“»«« program. ate eaallv 

the aMcIft'c imerftrtn ’^** becomln * mon P°P ullr ">>»<' u»ed to be. Although 

variable value In the C data aegment oe by returning a variable in ih<- »?* "f ' ' 
(Thla aecond method for returning a variable b not covered In this rh.nr,^ 

•hown in example. ebewhere In thb book.) *" ,hto chl ‘ ,,er bul '» 


l 
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CHAPTER 


14 

Interfacing with 
dBASE III + and FoxPro 


O M«i nrvf mOSt W,dC ^ y USCd hi8h * ,cveI lan R ua Rcs for business applications of 
MS Dos computer has no official name. The language originated as the com- 

d v f if T ?°^ Ular dalabasc management systems. Ashton Tate s 

d r II. As dBASE III evolved through versions III and III+ into the current dBASE 

, ° lher f,n " s / ound a markcl for enhanced dBASE clones, and as a result the 
an R ua ge and the product began to lead separate lives. 

Recently. AshtonTate dropped their copvrtght claimst the language, which 

tta^.ha,' ' T Tn? i " d Wh ” thCir CDm P <!,i,or5 •“« »yl"8 for some 

tune that dBASE is a full language in its own right. 

-Die many different implementations of the dBASE language are referred to 
collectively as xBase. Most of these implementations feature among their core 

o^^ W ^^ C ° n J P J ,t ! bait) ' thcAshlQn Tarc '* r * io * result is that most 

actions as^in^L^ ^ P ’ ** “J*? 1 * ,an8ua8C rouli n«. to do such common 
actions as turning the cursor on and off. or saving a screen while displaying help data. 

5 0nUnatdy * the xBxsc ,an Ruage provides commands that work together to 
provide such assistance. b 10 

J LOAB brings a .separately assembled support procedure into memory and 
makes u available to the xBase program. 

° CXCCU,iMn ° f lhc LOAOcd pro8ram ‘ n much the same way that 

tnc gosub statement operates in BASIC. 
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•J RELEASE MOOULE can be lined ro remove from memory any LOADed program 
ihai in no longer needed, freeing space for other modules. Us use is o,v 
tional; LOAD and call must be used together. 

In dBASE 111+ a maximum of 5 separate support files, each up to J2K in size, 
can be LOADed into memory at the same time. Any or all p( them can then Ik* CALLed 
as required, both load and call commands can be included in FK(i program files or 
issued interactively from the dot prompt. If you use FoxPro or dUASE IN. the number 
of loadable files increases to 16. with a maximum size of 6-iK each. 

If you're an old hand at xBase, you can skip the rest of this section and go 
directly to the section tilled "General Interfacing Guidelines.'’ If you're a newcomer 
to the world of xBase, however, you may find these terms confusing. Here's a brief 
explanation. 

All of (he conventional implementations of the xBase language (such as dBASE 
111+ and IVi or FoxPro 2.0) operate primarily as interpreters in an interactive mode. 
That's the way DOS itself works. Just as DOS issues the C> prompt to let you know 
it’s ready for a new command, the xBase program issues a dot prompt, consisting of 
a single period at the left margin, to let you know when it's ready for another 
instruction. And just as DOS enables you to string a sequence of commands together 
into a BAT file and (hen execute the entire stream of actions without individually 
typing each ai the command prompt, the xBase program provides command files 
with the same capability. Because the command file is indicated by the extension 
PRG in xBase, such files commonly are called PRG files. 

Other special file extensions used by xBase include MEM for files of saved 
memory' variables (memvars) and BIN for the assembly language support routines 
this chapter discusses. There are many more, but these are the only ones you need 
to know about in this chapter. 


General Interfacing Guidelines 

Certain restrict ions are imposed on BIN files to ensure that they are completely 
compatible with the xBase interpreters: 

J The file must be a pure memory image, like a COM file, instead of being in 
the relocatable EXE format usually produced by most linker programs. 

J All memory addresses in the file must be relative to zero. That is. the 
assembly language source must contain an implicit or explicit ORG 0 state¬ 
ment; this differs from conventional COM-filc usage, which requires an ORQ 
QiQGh starling point. 
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Chapicr 14 Interfacing with UllASE 111+ and FoxPro 


□ Because the fiie is accessed by a far call from the interpreter, it must use 
the far version of RET to return to its caller. 

□ The CS and SS registers must both be returned to the caller holding the 
same values they hod at entry. This means that if your procedure changes 
the registers, it must save the original values and restore them before 
returning. No other registers need be preserved by your routine. 

□ All code.and working data storage must be contained within a single 64K 
segment (32K for dBASE III + ). The procedure must not attemp't to access 
any data maintained by the xBase program, except through the parameter- 
passing mechanism provided. This restriction, however, does not apply to 
accessing data outside the xBase program, such as the BIOS data area, the , 
video RAM, and so forth. 

□ Your assembly language program must not change the sire or length of any 
variables passed to it. 

□ The BIN file must not contain a STACK segment or make any reference to 
other segments that would have to be resolved when the file is linked. 
Failure to observe this restriction may make converting the file to the 
required memory-image format impossible. 

To prevent confusion, the file name used for the BIN file and the procedure 
name used for the internal procedure should be identical. Thus, the proced¬ 
ure name must follow DOS file-naming conventions—most notably, the procedure 
name can be only as many as eight characters long The xBase program uses only one 
lookup table. This table, which is set up to refer to the file name when you LOAD the 
file, is used later to find the procedure when you CALL it. Thus, only one callable 
procedure can bt contained in each BIN file. 

The procedure name is unimportant to the system itself because that name 
never gets through to the xBase interpreter; only the file name is ever known to 
xBase. Keeping track of things is much easier, however, when your ASM files and 
yriur PRG files use the same names for procedures. 

Interfacing Subroutines without 
Variable Passing 

To understand how the restrictions on BIN files apply in practice, consider first 
the simplest types of BIN files—those that - simply perform a procedure without 
needing data from the calling program or passing any values back to it. 
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II: Mixed Language Programming with Assembly Language 


One such procedure, which fills a real need in dBASE I1I + , is a routine that 
turns off the cursor when it is called. Although FoxPro and other competitors 
added special capabilities for cursor control, dBASE 111+ lacks such a feature. Let’s 
look first at turning off the cursor and then at turning the cursor back on. 


Turning Qff the Cursor 

The video BIOS turns the cursor on and off. The assembly language procedures 
call BIOS to get the current cursor condition, change it, and call BIOS again to put 
it back. Here’s how to turn off the cursor: 

Page 69,132 
Comment { 


File: CUROFF.ASM 

Author: Allen L. Wyatt 

Date: 10/1/91 

Purpose: Turn the cursor off from an xBase program. Requires 

no parameter passing. Particularly of use from a 
* dBASE III+ program. 


* Format: LOAD curoff 

CALL curoff &&' to turn cursor OFF 

****••«•#**••**«#****•***•*••••••••••••*•••**••••••*•**•*•*••*••••• 

I 


CODE 

SEGMENT 

BYTE PUBLIC *C00E 

• 


ASSUME 

CS:C0DE 



ORG 

0 


CurOff 

PROC 

FAR 



MOV 

AH,03 ; 

Read cursor information 


INT 

i0h. ; 

using BIOS 


OR 

CH,20h ; 

Set cursor off bit 


MOV 

ah ,01 ; 

Set cursor type 


INT 

i0h ; 

using BIOS 


RET 



CurOff 

ENOP 



CODE 

ENDS 




END 
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" " 1 


This file, when assembled and linked as described later in this chapter, creates 
a 12-byte BIN file. If the file is named CUROFF.BIN, the command load curoff will 
bring it into memory and make it available to xBase, and a subsequent command, 
CALL CUROFF, will make the cursor vanish. 

Although this example is indeed tiny, it does illustrate all the major require¬ 
ments of an assembly language source file for any BIN-file routine. Everything is 
contained in a single segment (CODE), the program begins at zero (ORG 0 ), and the 
code is declared as PR0C FAR, which ensures that the proper type of RET opcode is 
generated. 

The cursor is turned off by the single line OR CH,20h; this bit ’nstructs the CRT 
controller on the video card to shut off the cursor until further notice. The code 
before that ensures that the CX register contains the proper cursor-size information 
when the second call sends the data back to BIOS. 


TXiming On the Cursor 

Now that you can turn off the cursor, you need a corresponding capabiiiT Y 
turn the cursor back on the next time you want it to show up on-screen. The 
following code provides this capability: 

I 

Page 60.132 
Comment | 


File: CURON.ASH 

Author: Allen L. Wyatt 

Date: 10/1/91 

Purpose: Turn the cursor on from an xBase program. Requires 
no parameter passing. Particularly of u^e from a 
dBASE III* program. 

Format: LOAD curon . 

CALL curon && to turn cursor ON 


WOE SEGMENT BYTE PUBLIC ’COOE* 

ASSUME CS:COOE 
ORG 0 
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... i anguagc Programming-*)* Assembly Unguage 


CurOn 

PROC 

FAR 


MOV 

AH ,03 

; Read cursor information 


INT 

ICh 

; using BIOS 


AND 

CH, 1 Fh 

; Clear cursor pff bit 


’ MOV 

AH ,01 

; Set cursor type 


INT 

RET 

ieh 

; using BIOS 

CurOn 

ENDP 


. 

CODE 

ENOS 

END 

* 

• 


The only difference between this routine and that shown in the preceding 
section is the line and ch , 1 Fh. Where that example set the cursoroff bit to 1 by ORing 
in a value of 20h, this routine uses the inverse operation to force that same bit to 
zero so that the CRT controller can enable the cursor to show once again. 

Because you can load several BIN hies at once with xBase, you can LOAD both 
CUROFP and CURON and, then alternate calls to diem for full cursor control. 

And even though FoxPro provides a special SYS() function that can be used to 
do the same thing, many developers who support several implementations of xBase 
prefer to use identical code for all of them, to keep the maintenance job simpler. 
These routines work not only with dBASE but also with FoxPro. 

Interfacing Subroutines with 
Variable Passing 

While the two preceding examples describe the techniques for creating and 
using BIN files, most assembly language routines you write will probably require that 
information be passed in from or hack to the caller. Although the xBase language 
provides the capability to pass information, the capability is somewhat restricted, 
compared to C or Pascal. 

tii addition to the simple CALL statement used with the preceding examples, 
you can use the statement 

CALL procedure WITH parameter 

to pass a single paramefei to your procedure. The procedure can then return any 
results in that same parameter. 

Unfortunately, usually only one parameter can be passed (dBASE IV can pass 
more, as is explained later). When your routine is entered, the segment address of 
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that single parameter ,s in the IXS register and its offset is in BX (If no 
passed in w -BX contains 0.) 1 


parameter is 


Alt tough the official language definitions all agree that a character expression, 
or a memory variable of any type can be passed in the call statement, the practice 
of using a memvar of type • character” as the parameter is almost universal. You can 
use such a memvar as a buffer to pass data that is not necessarily in character format. 

The following additional restrictions are imposed on a parameter when it is 
passed: 

Q The size of the parameter may not be.changed by your routine; if the result 
takes less space than the parameter passed in, your routine must handle it 
1)y some method other than changing the parameter's length. 

Q ff a character (or string)wariable is involved, never try to save its address 
from one call of your routine to the next. Some implementations of xBase 
move data in memgry as much as BASIC does. Always get addresses imme¬ 
diately before they are to be used to ensure that they are correct. 

The limit of only one parameter makes it necessary to pass multiple arguments 
as astring, which may include several fields in ASCII with commas as delimiters. Such 
a string cannot contain bytes that are all zeroes, and its maximum size is 254 bytes. 


Saving and Restoring the Screen 

To understand how data is passed into a procedure, consider the program 
SCRUTLASM. This procedure can save and restore up to three screens. FoxPro 
provides this capability in its implementation, but dBASE III + does not SCRUTL.BIN 
works with both dBASE 111+ and FoxPro, and can easily be expanded to save up to 
12 screens of information. Several similar programs have been published; this 
example combines the best features of all: 

Page 64,132 
Comment J 


Pile: SCRUTL.ASM 

Author: Allen l. Wyatt 

Date: i«/i/gi 


Purpose: Save fcnd restore the screen fro* an xBase program. 

Requires one parameter, as shown in the Format section. 
This routine allows tor three screen save areas, but 
■ore could be added if desired. If called from FoxPro, 
you should use the SAVE keyword with the call function. 
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Format: 


CODE 


Scrutl 


Mono: 


Save: 


LOAD scrutl 
Opcode » 'SI' 

CALL scrutl WITH Opcode' 
Opcode * ’R1’ 

CALL scrutl WITH Opcode 


&& to save screen area 1 
&& call routine 
&& to restore screen area 1 
&& call routine 


SEGMENT BYTE PUBLIC ‘CODE* 


ASSUME 

CS:COOE 

/ 

ORG 

e 


PROC 

FAR 


PUSH 

BX 


MOV - 

AH.BFh 

; Get video state 

INT 

• 1«h 


CMP 

AL,7 

; Is it monochrome display node? 

MOV 

AX,0B000h 

; Preset video segment for monochrome 

JE 

Mono 

; Flags still set from CMP operation 

ADO 

AH,8 

: Adjust video segment for color 

POP 

BX 

. 

MOV 


; Get 2-byte variable from xBase DL ■ 

PUSH 

CS 

; Set data segment properly 

POP 

DS 


SUB 

DH,’1 ’ 

; Make area number 0-based 

CMP 

DH ,2 

; Is it out of 0-2 range? 

JA 

WindUp 

; Yes, so ignore invalid parameter 

SHL 

DH, 1 

; Multiply by 2 

MOV 

BX,OFFSET AreaTable 

ADO 

BL.DH 

; Adjust for area pointer 

AND 

DL,5Fh 

; Force code to uppercase 

CMP 

DL, ‘S 1 

; Want to save the screen? 

JE 

Save 

; Yes, so go handle 

CMP 

DL, 

; Want to restore the screen? 

JE 

Restor 

; Yes, so go handle 

JMP 

SHORT WindUp 

• ; Invalid code, so ignore it 

PUSH 

CS 


POP 

ES 

; Set destination segment 

MOV 

DI,(BXJ 

; Get address from table pointed to by 

MOV 

DS.AX 

; Move segment address for video RAM 

MOV ' 

SI ,0 



DH 
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JMP 

SHORT Xfer 

Restor: 

MOV 

SI»(BX) 


MOV 

ES.AX 


MOV 

01,0 

Xfer: 

MOV 

CX,25*80 


CLO 



REP 

MOVSW 

WindUp: 

RET 


Scrutl 

• 

1 . 

ENDP 


AreaTable 

DW 

OFFSET Areal 


OW 

OFFSET Area2 


DW 

OFFSET Area3 

Areal 

pw 

2000 OUP (0) 

Area2 

DW 

2000 OUP (0) 

Areas 

DW 

2000 DUP (0) 

CODE 

ENDS 



END 



; Go do actual transfer 

* Get address from table pointed to by BX 
; Move segment address for video RAM 

; Want to move full screen 
; Be sure of transfer direction 
; Perform block move 


; screen save areas 
; (in SEG but not PROC) 


Although much larger than the previous examples in thiscnapter, SCRUTL.BIN 
is not much more complex. It begins by determining whether it is running with a 
monochrome or a color monitor and placing the appropriate segment address 
(B000h for mono or B800h for color) of the video RAM in the AX register. 

The program then uses the parameter address ir« BX to load the first two bytes 
of the parameter string into the DX register. The first byte goes into DL and the 
second Into DH. This is all done by a single instruction to move a 16-bit value. 

Because accessing the calling program's data area is complete, the data 
segment can now be set equal to the current code segment in order to access the 
data built into the routine. 

The next step is to determine what screen area the user wants to save or restore. 
This is done by convening the number in DH into a number between 0 and 2. If the 
number is out of this range, the routine is exited with no action taken. If the number 
is in range, it is multipled by 2 and added to the offset of the screen-area table that 
has been loaded into the BX register. The value in BX now points to the correct table 
entry for the address of the appropriate memory area. 
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The byte In DL should be either S (for save, or R (for restore). The byte in DL 
is masked against 5Fh to convert it from lowercase to uppercase ,f necessary the 
not a letter or is already uppercase, th.s step doesn t change any.hmg If the 
resulting byte is S, control jumps to the label Save; if I. is «. control goes to Res,or. 
If the byte is neither S nor R, control goes to windup, which returns to the caller 

without doing anything else. 

At either Save, or Restor, the source and destination addresses are set and 
control is transferred to Xfer. 


At Xfer, CX is loaded with the proper number of words to transfer. Note the use 
of assembly-time aridunetic to calculate this number in terms of rows and columns. 
This use of assembly-time arithmetic makes modifying the routine to support other 
display sizes simpler. Next, a CLD instruction ensures that the move will be made in 
the correct direction (see Chapter 22, “Processor instruction Sets,” for details of why 
this is needed), and a REP movsw instruction causes a block move of data from DS:SI 
to ES:Dl, continuing for the number of words specified by the value in CX. 

Finally, control goes to wmdUp, which returns to the caller. The specified area 
now contains an exact copy of the current content of the video RAM. 


Interfacing for dBASE IV 

Interfacing to a BIN file with dBASE rv is a bit more comnlex and flexible than 
with dBASE III + . The main difference is that up to seven arguments can be passed 
rather than just one. As in the other xBase implementations, the address of the first 
parameter is passed in DS:BX. The number of values being passed is in the CX 
register, however, and the addresses are placed in a table of fab (four-byte) pointers. 
This table begins at the address in ES:DI. 

Any BIN file created to wo-k with the i older xBase implementations will work 
with dBASE IV, but dBASE IV BIN files will not necessarily work with the older 
xBase implementations. If you want maximum portability of your routines from one 
version of xBase to another, you must avoid using the multiparameter capability. 
For this reason, no example of this capability is provided. 

Assembling and Linking 
the BIN Files 

Every assembly language program used with the LOAD and CALL capability must 
be assembled, linked, and convened to a BIN Hie The derails of doing this differ 
according to the .v- scmbler and linker you use. 7 he major differences arc among the 
link steps. 
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No matter which assembler you use, the technique for assembling your BIN- 
flic routine Is t c same. To create an OBJ file that the linker can use. you should 
Invoke the assembler as described in Chapters 5 (“Using Microsoft's Assembly 
Language Products ) and 6 ("Using Borland’s Assembly Language Products"). 

If the assembler reports warning messages or errors, study them carefully and 
correct their causes before proceeding. You may need to reassemble the program 
and specify that a LST file be output to find the exact spots at which the errors occur. 

Only when the assembly step reports no problems should you proceed to the link¬ 
ing action. 

When your routine is successfully assembled into an OBJ file, you must convert • 
that OBJ file into the final BIN file by using your linker program and, in some cases, 
other utilities. 

If you use Borland's TLINK, you can create the final file in a single step by using 
the following command line: 

C>TLINK it scrutl,scrutl.bin; 

which automatically forces the output file to meet the BIN-file requirements. The 
It option switch is necessary. (If you are linking th? other files—CURON and 
CURO c F—you should substitute their names for SCRUTL in this example.) 

If you are using Microsoft's LINK, the procedure is slightly more complex You 
need to follow these three steps: 

1. Link the OBJ file into EXE format as follows (you can safely ignore the one 
or rwo warning messages, which are normal in this case): 

C>LINK scrutl; 

2. Convert the EXE file into BIN format: 

OEXE2BIN scrutl 

3. Delete the intermediate file: 

C>DEl scrucl.exe 

Again, if you are working with CURON or CUROFF, use those file names in the 
appropriate places. 


Using the BIN Files 

Once you have created your BIN files, you can use them in PRG files to be 
executed by cither dBASE or FoxPro, or you can use them directly from the dot 
prompt in an interactive mode. 

0* 
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II; Mixed Language Programming with Assembly Language 


The following program, SCRUTL. PRG, Is designed to be used from dBASE or 
FoxPro. It demonstrates the proper use of BIN files. 

SET STATUS OFF 
SET SCOREBOARD OFF 
SET TALK OFF 

LOAD scrutl 
LOAD curoff 
LOAD curon 

SET COLOR TO W/B 
CALL curoff 
CLEAR 

1 > 2 

00 WHILE i < 22 

■ 0 i, i SAY 'Test screen for using Assembly Language, 3rd Edition' 

i = i*i 
ENDDO 

SET COLOR TO W/N 

9 1,21 SAY * Using Assembly Language, 3rd Edition * 

SET COLOR TO W/N 

0 22,0 SAY SPACE(75) 

0 21,0 SAY '• 

WAIT 

0 22,0 SAY SPACE(75) 

CALL scrutl WITH "SI* 

0 5,5 CLEAR TO 10,20 
0 5,5 TO 10,20 DOUBLE 
0 6,6 SAY ’This is Area 1* 

CALL scrutl WITH *S2* 

0 21,0 SAY •* 

WAIT 

0 22,0 SAY SPACE(75) 

SET COLOR TO N/W 
0 7,0 CLEAR TO 20,70 
0 7,8 TO 20,70 
0 8,9 SAY ’Here's Area 2* 

SET COLOR TO W/N 
0 21,0 SAY •* 

WAIT 
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0 22,0 SAY SPACE(75) 

CALL scrutl WITH 'S3* 

SET COLOR TO N/N 

0 13,25 CLEAR TO 20,61 && create the shadow 

SET COLOR TO W+/B 

# 12,24 CLEAR TO 19,60 && create the window 

0 12,24 TO 19,60 DOUBLE && draw the border 

0 13,25 SAY ‘And in Area 3 a shadowed display* 

0 15,25 SAY *(By the way; notice that the cursor* 

0 16,25 SAY * has been turned off up to this* 

0 17,25 SAY * point. It will be turned on in the* 

0 18,25 SAY * next screen.)* 

SET COLOR TO W/N 
t 21,1 SAY ** 

WAIT ’Press any key to begin removing windows* 

CALL scrutl WITH *R3* 

0 21,1 SAY * * 

CALL curon 

WAIT 'Restored from area 3* 

CALL scrutl WITH *R2* 

0 21,1 SAY ** 

WAIT 'Restored from area 2* 

* 

CALL scrutl WITH *R1* 

0 21,1 SAY ** 

WAIT 'Demo completo, press any key to return to DOS* 

QUIT 

Note that to use this program successfully from FoxPro, you should change 
the CALL statements for restoring the screen, as follows: 

CALL scrutl WITH *R3* SAVE 
CALL scrutl WITH *R2* SAVE 
CALL scrutl WITH *R1* SAVE 

This alteration causes the program to work properly with the way FoxPro handies 
video screens. 

Although this demonstration program performs a fairly worthless task, the 
program structure itself demonstrates a number of techniques made possible by 
the BIN files described in this chapter. These techniques can be used in your 
production programs to add a more professional touch to the screen displays. 
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Summary 

The xBase language may be the most popular high-level language used today 
for business applications In the MS-DOS environment. This chapter showed you 
how to create assembly language modules to extend the capabilities of that lan¬ 
guage and how to use those modules In your programs. 
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Interfacing with Clipper 


T he Clipper package from Nantucket, Inc., compiles a superset of the DBMS 
language used by dBASE and FoxPro Into stand-alone programs. The Clipper 
programs do not require that a run-time module be furnished to the end user, 

A major feature available with Clipper is that you can code just about anything 
you need, using either C or assembler, and then link it with the Clipper-generated 
OBJ file. With this capability, you can extend the language almost any way you want. 

The only drawback to this feature Is that it has changed at each major update 
to Clipper. The techniques described in this chapter are those used with Clipper 5.0 
or 5.01. These versions changed slightly from the previous (Summer ’87) version, 
which was a drastic change from earlier versions. 

Before getting Into a detailed discussion of Interfacing with Clipper, a defini¬ 
tion of terms may be in order. If you already are familiar with Clipper terminology, 
you can skip the next two paragraphs. 

Clipper source files, like source files In dBASE, are stored In ASCII program files 
with the extension PRG. These PRG files are nothing mysterious; they just hold the 

program source code written with the xBase language and any Clipper extensions 
to the language. 

UDF is an acronym for ujer-dqflned Junction. These are the external func- 
uons—written either in Clipper or in a non-xBase language—that are linked to your 
upper application when it is compiled. UDFs are created and linked with Clipper 
through the Extend System, Clipper’s interface for assembly language and C 
programmers. 
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General Interfacing Guidelines 

When interfacing assembly language routines to Clipper, you must followa few 
well-defined rules. It’s absolutely essential that between entry to your routine and 
return to Clipper you preserve unchanged the values of the DS, SS, BP, SI, and Dl 
registers. All other registers can be modified as needed. 

Clipper, unlike compiled BASIC, Pascal and C, does not generate true native 
m ach ine code. An EXE file generated by Clipper consists of one call to Clipper s 
internal run-time interpreter for each PRG file contained in the EXE file. These calls 
are followed by a sequence of bytes in Clipper’s oWn proprietary Internal 
“tokenization." The run-time interpreter translates these tokens ir^> calls to the 
native-code library routines. ' * 

Because of this translation, when you write a UDF in assembly language (or 
in C), you must always use the subroutines furnished with Clipper (as part of 
the CL 1 PPER.UB file) to communicate with your UDF. If your function doesn’t 
pass information, you do not need 10 use CUPPER.LIB; one example of such a UDF 
would be a function that changes the cursor shape. 

Most useful functions either pass information horn the calling program or 
return data to the calling program, however. Because Clipper’s data-storage struc¬ 
ture is not directly accessible to your assembly language code, such functions require 
routines from CUPPER.LIB to perform either of these tasks. 

The techniques described in this chapter work equally well with either MASM 
orTASM. One thing you should note, however, is that you should not assemble your 
program with the options to include CodeView or Turbo Debugger information. 
The extra debugging data embedded in the OBJ file prevents Clipper from property 
using your code. 


Interfacing Subroutines 

Many of the examples in earlier chapters deal with cursor control. The 
examples in this chapter do as well, although Clipper provides a cursor-control 
function. Instead of pursuing capabilities that only duplicate built-in Clipper 
functions, however, the sample code in this chapter shows how to do something 
Clipper will not do. Although many languages change the shape of the cursor to 
indicate whether you are operating in insert or overty pe mode, Clipper does not 
provide this capability. 

Three examples—each a bit more advanced (and therefore a little more 
complicated) than its predecessor—are presented. 
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The first example shows how to interlace without passing any parameters or 
returning any values. The code consists of three different functions, each of which 
first uses BIOS to read the current cursor information, then modifies it and puts it 
(pack. One function turns the cursor into a regular line, one into a half block, and 
one into a full block. 

The second example shows how you can use the parameters to make just one 
procedure do the entire job. The si 2 es are specified by a code number passed into 
the function from Clipper; a code of l makes the cursor a line. 2 is a half block, and 
3 is a full block. 

Because both of these examples go directly to BIOS to change the cursor sue, 
Clipper’s internal record does not reflect the actual cursor condition. This makes the 
built-in SET CURSOR function unreliable, and makes it difficult for your program to 
' determine the previous condition of the cursor. Therefore, the third example adds 
a value-return capability to the second example, so that it tells your program what 
the cursor condition was before you changed it. This is exactly like (and is modeled 
from) the existing Clipper SETCOLORQ function action. 

In all three examples, the same basic plan is followed: first, ask BIOS what type 
of cursor is presently displayed; then go to BIOS again to change the cursor type. 

f 

Interfacing Subroutines without 
Variable Passing 

First, let’s look at an example of code that does not require variable passing. 
The following assembly language subroutine requires a separate function to per¬ 
form each action: 


Page 60,132 
Comment ! 


File: CLIPEX1 .ASkl 

Author: Allen L. Wyatt 

Date: 10/29/91 

Purpose: Clipper example programs, 1st pass: cursor sizing 
with no parameter passing. 


Format: CurLineO 

CurHalf() 
CurBlocM) 
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CurLint 


CurLlne 

CurHalf 


CurHalf 

CurBlock 


CurBlock 


PUBLIC CurLlne, CurBlock, CurHalf 


.MODEL 

large 


.CODE 



PROC 

FAR 


MOV 

AH,3 

; Ge- current cursor 

XOR 

BX, BX 

; Clipper uses Page 0 only 

INT 

ICh 

; Start In CH, end in CL 

AND 

CL.IFh 

; Be sure it’s ON 

MOV 

CH.CL 

; Copy endline to startline 

DEC 

CH 

And back up by 1 

MOV 

AH, 1 

Set new cursor values 

INT 

ICfl 


RET 



ENDP 



PROC 

PAR 


MOV 

AH ,3 

Get current cursor 

XOR 

6X,BX 

Clipper uses Page 0 only 

INT 

'.Oh 

Start in CH, end in CL 

AN 0 

CL,1Fh 

Be sure it's ON 

MOV 

CH, CL 

Copy endline to startline 

SHR 

CH, 1 

And divide start by 2 

MOV 

AH, 1 

Set new cursor values 

INT 

10h 


RET 



ENDP 



PROC 

FAR 


MOV 

AH, 3 ; 

Get current cursor 

XOR 

GX.BX ; 

Clipper uses Page 0 only 

INT 

ICh ; 

Start in CH, end in CL 

AND 

CL, 1 Fh ; 

Be sure it's ON 

XOR 

CH,CH ; 

Force start to scanline 0 

MOV 

AH, I ; 

Set new cursor values 

INT 

lOh 


RET 



ENDP 



ENO 
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Although this looks like a great deal of coH#» . . . 

four copies of ihc same procedure. These procedures van’ nni' i * y S8cnt ^*V 
the Cl. register (us, before the second L lOh ”” Hve™i?„ ^ 
unchanged from one procedure to the next k'Whmg else remain. 


r 


Notice the following items about this routine: 


□ The large memory model is used 
Q Each procedure is declared as Far 

□ All entry ports (in this case, the four procedure names) arc declared PUBLIC 
with Chppe^ thCSe ' tCmS ' S CSSential for aU assemb, y language routines you interface 


In each of these procedures, BIOS function Interrupt 10/03 was used to read 
‘ ,. CUI J or position and size. Upon returning. CH holds the startline value and CL 
holds the endline value; these two values together define the cursor shape These 
values can then be modified and, by using the BIOS function to set the cursor size 
(Interrupt 10/01). the shape of the cursor can be changed. The trick is to adjust 
appropriately the values in CH and CL. 


To make sure that the cursor is on, and the bits in CH with lFh. To create a line 
cursor, set the startline (in CH) to one less than the endline value (in CL) This is the 
same type of cursor normally used in Clipper For a half-block cursor, set the startline 
value (CH) to be half the value of the end! :ie value (CL). Finally, for a block cursor 
force the startline value (CH) to zero. 


Now that the values have been modified, they are used to set the cursor size 
with the proper BIOS function, and control is passed back to the caller—in this case, 
the Clipper program. The following short Clipper program, CLTEST1.PRG, can be 
used to test the routines: 

SET STATUS OFF 
SET SCOREBOARD OFF 
SET TALK OFF 

CLS 

^ C, c SAY ’This is a test of the CurLine, CurHalf, and CurBlock functions* 

* 3i 0 SAY ‘This is regular cursor* 

INKEY(0) 

p 6, 0 SAY ‘This is with the cursor as a line* 

CurLine() 

INKEY(O) 

^ 9. 0 SAY This is with the cursor as a half block* 

CurHalf() 
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INKEY(t) 

9 12. • SAY 

CurfilocM) 

XMttY(t) 


•This is with the cursor as a block' 


QUIT 

Interfacing Subroutines with 
Variable Passing 

The routines in the preceding example illustrate the simplest possible inter¬ 
face of assembly language and Clipper programs, but it would be better if just one 
routine could do all three jobs. This can be done by adding a few lines of code to pass 
a numeric parameter from the Clipper program, as follows: 

PaQS 60,132 
Comment \ 


Fils: CLIPEX2.ASU 

Author: Allen L. Wyatt 

Date: 16/29/01 * 

Purpose: Clipper exaaple programs, 2nd pass: cursor sizing 

with parameter passing. Routine accepts a value that 
indicates how to set cursor. 

Format: CurSet(x) 

1 ■ Line cursor 

2 ■ Half-block cursor 

3 • Block cursor 

( 

EXTRN _PARNI:FAR ;Clipper routines 

PUBLIC CurSet 

.MOOEL large 
.COOE 
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CurSet 

PROC 

FAR 



MOV 

AX, 1 

;Get number passed in 


PUSH 

AX 



CALL 

_PARNI 

JUsing EXTENO facility 


POP 

BX 

;Throw away original stack value 


AND 

AX,3 

;Force to a valid value 


PUSH 

AX 

;Save the value 


MOV 

AH,3 

;Read cursor position and size 


XOR 

BX.BX 

;Clippar uses page 0 onJ 


INT 

10h 

;BIOS services 


AND 

CL,IFh 

;Make sure cursor is on 


MOV 

CH.CL 

;Copy endline to etartline 


POP 

AX 

,‘Retrieve uaved number 


CMP 

AX ! 

1 \ 

;Do we want to set to a line? 


' JNE 

CS1 

;No, go to next check 


DEC 

CH 

;And back up by 1 


JMP 

SHORT Setlt 


CS1: 

CMP 

AX,2 

;Do we want to set to a half block? 


JNE 

CS2 

;No, go to next check 


SHR 

CH, 1 

;And divide start by 2 


JMP 

SHORT Setlt 


CS2: 

CMP 

AX,3 

;Oo we want to set to a full block? 


JNE 

Exit 

;No, so exit 


XOR 

CH.CH 

;Force start to scanline 0 

Setlt: 

MOV 

AH, 1 

;Set new cursor values 


INT 

IBh 


Exit: 

RET 



CurSet 

ENOP 




END 


\ 


One of the first major differences you see here (besides the fact that it’s only 
one function rather than three) is the external declaration of the _ _PARNI procedure. 
This standard Extend-System routine retrieves a numeric integer-format parameter 
passed from Clipper, and returns it in the AX register. To tell _ _PARNI which 
parameter to get, push a value on the stack before calling _ _PARNI. Here, the 
program pushes the value 1 to tell __parni jo return the fint parameter being 
passed. 
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The Extend System provides routines that accomplish the following: 

□ Determine how many parameters were passed in the call 

□ Identify the type of each parameter 

Q Retrieve the value in each of the valid types 
Q Return values in each valid type 

These Extend-System routines arc described in more detail later in the chapter. 
For now, let’s look at the otner features added to this example. 

The value returned by __PARNI is ANDed with 3 to force the value to an 
acceptable range. The routine then preserves this value by pushing it onto the stack, 
and goes to the BIOS to Find the current cursor type (as is done earlier in the chapter). 
Here, only one such sequence suffices for all four actions After returning, the cursor 
type is in the CX register. In preparation for one of three operations that will set the 
final cursor shape, the routine ensures that the cursor is turned on, and makes the 
starting and ending scan lines the same. The routine then retrieves the value of AX 
from the stack. 

The value in AX is tested to determine what should be done to the cursor. 
Based on that value, the starting cursor scan line is set to the proper value, and the 
BIOS functions are used to set the new cursor shape. The procedure then returns 
to the Clipper program that called it. 

The following Clipper program, CLTEST2.PRG, can be used to test this 
subroutine: 

SET S1ATUS OFF 
SET SCOREBOARD OFF 
SET TALK OFF 

CLS 

90,0 SAY 'This is a test of the CurSet() function' 

0 3, 0 SAY 'This is reflular cursor' 

INKEY(0) 

0 6, 0 SAY 'This is with the cursor as a line' 

CurSet(1) 

INKEY(0) 

0 9, 0 SAY 'This is with the cursor as a half block' 

CurSet(2) 

I.NKEY(O) 

0 12, 0 SAY 'This is with the cursor as a block’ 

CurSet(3) 

INKEY(0) 

QUIT 
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Interfacing Subroutines that Return Values 


To return a value to the 
cursor condition was, all that’s 
lines of code: 


Clipper program that indicates what the previous 
necessary is to add one byte of storage and a few 


Page 60,132 
Comment | 


File: CLIPEX3.ASM 

Author: Allen L. Wyatt 

Date: 10/29/91 

Purpose: Clipper example programs, 3rd pass: cursor sizing 
with parameter passing in both directions. Routine 
accepts a value that indicates how to set cursor, 
and returns a value indicating how the cursor was 
set before the call. 

Format: EXTERNAL CurSet 

OldCurVal = CurSet(x) 

1 s Line cursor 

2 * Half-block cursor 

3 = Block cursor 


I 

I 



EXTRN 

_PARNI:FAR 

; Using Clipper routines 


EXTRN 

__RETNI:FAR 



PUBLIC 

CURSET 



.MODEL 

large 



.DATA 


• 

OldVal 

DB 

1 

; Stores last value 


.CODE 



CurSet 

PROC 

FAR 



MOV 

AL,OldVal 

;Get current value 


PUSH 

AX 

;and save it for now 


MOV 

AX, 1 

;Get number passed in 

’ k 1 * -* 

PUSH 

AX 
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CALL 

_PARNI 

;Using EXTEND facility 

POP 

BX 

;Throw away original stack value 

AND 

AX,3 

;Force to a valid value 

MOV 

f 

OldVal ,al 

;Save for next call 

PUSH 

AX 

;Save the value 

MOV 

AH,3 

;Get cursor position and size • 

XOR 

BX.BX 

;Clipper uses Page 0 only 

INT 

IBh 

;BIOS services 

AND 

CL.IFh 

;Make sure cursor is on 

MOV 

CH.CL 

;Copy endline to startline 

POP 

AX 

;Retrieve saved number 

CMP 

AX, 1 

;Do we want to set to a line? 

JNE 

CS1 

;No, go to next check 

DEC 

CH 

;And back up by 1 

JMP 

SHORT SetIt 

• 

CS1: CMP 

AX, 2 

;Do we want to set to a half block? 

JNE 

CS2 

•;No, go to next check 

SHR 

CH, 1 

;And divide start by 2 

JMP 

SHORT SetIt 


CS2: CMP 

AX,3 

;Do we want to set to a full block? 

JNE 

Exit 

;No, so exit 

XOR 

CH,CH 

;Force start to scanline 0 

Setlt: mov 

AH, 1 

;Set new cursor values 

INT 

IBh 


Exit: POP 

AX 

;get original OldVal back 

CBW 


;extend the sign bit 

PUSH 

AX 

;push down for __RETNI 

CALL 

_RETNI 

;using EXTEND facility 

POP 

AX 

;Throw away value on stack 

RET 

CurStt ENOP 



ENO 



The added 

byte of storage. 

Oldval, is initialized to 1 because all Clipper 
set to a line. 

applications start with the cursor j 

At each call «o CurSat. the current comcm of oiav.i la first pushed onto the 

• o r.:°f„r “ ^ "* ro, ;!‘ nc 15 ,0 ,,orc ,he n *" ™™>r-sh,pe code Into 

OldVal for use on the next call. 
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Fi ■'ally, after the new cursor condition has been set, the original value of Olava i 
la brought back from rite auck, convened from a byte to a word.^d ^^d ^ 
caUmgprocedute aa the valueof the function by the tecond EvtendSyaS^ 

aubro^ IIOW,ng C ' ,PPer Pro8nUn ' CLTEST3 PRG ’ enabl « you to teat thla Uteat 


SET STATUS OFF 
SET SCOREBOARD OFF 
SET TALK OFF 

CLS 

• • SAY 'This is a tast of the CurSetO function, returns a value* 

B 3, 0 SAY 'This is regular cursor* 

INKEY(t) 

» 

OldVal :» CurSet(i) 

0 5, 0 SAY 'The original cursor value was ' ♦ TRANSFORM (OldVal, '06') 

0 6, ® SAY 'This is with the cursor as a line* 

INKEV(O) 

OldVal :« CurSet(2) 

0 8, 0 SAY 'The cursor value was * ♦ TRANSFORM (OldVal, 'SB') 

0 9, 0 SAY 'This is with the cursor as a half block' 

INKEY (, 0 ) 

OldVal :» CurSet(3) 

0 11, • SAY ‘The cursor value was • ♦ TRANSFORM (OldVal, •08*) 

0 12, 0 SAY 'This is with the cursor as a block' 

INKEY(0) 


QUIT 


The Extend System Functions 

can W f? thC 27 Extcnd ’ s y* tcm Unctions CUpper provides in CLIPPER.LIB, you 
7*7 lnte «ace between Clipper programs and assembly language UDFs. The 
•ollowing are declarations for the 27 functions: 
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EXTRN 

_ _PARC:FAR 

EXTRN 

~ _PARCLEN:FAR 

EXTflN 

_ _PARDS:FAR 

EXTRN 

__PARINFA:FAR 

EXTRN 

__PAR INFO :FAR 

EXTRN 

_PAR L: FAR 

EXTRN 

_PARND:FAR 

EXTRN 

_PARNI[FAR 

EXTRN 

_PARNL:FAR 

EXTRN 

_RET:FAR 

EXTRN 

_RETC:FAR 

EXTRN 

_RETCLEN-.FAR 

EXTRN 

_RETDS:FAR 

EXTRN 

_RETL:FAR 

EXTRN 

_RETND:FAR 

EXTRN 

_RETNI:FAR 

EXTRN 

__RETNL:FAR 

EXTRN 

_STORC:FAR 

EXTRN 

_STORCLENrFAR 

EXTRN 

_STORDS:FAR 

EXTRN 

_ _ST0RL:FAR 

EXTRN 

_STORND:FAR 

EXTRN 

_STORNItFAR 

EXTRN 

_ _ST0RNL:FAR 


[Receive 3 character parameter 
;Gct length of a character parameter 
[Receive a date parameter 

[Get length of an element or array parameter 
[Get parameter count or data type 
[Receive a logical parameter 

[Receive a double-precision floating-point parameter 
[Receive an integer parameter (one byte) 

[Receive a long integer parameter (one word) 

[Return a NIL value 

[Return an ASCIIZ string (null -terminated) 

[Return a string of specific length 
[Return a date value 
[Return a logical value 

[Return a double-precision floating-point value 
[Return an integer value 
[Return a long integer value 

[Assign an ASCIIZ string (null-terminated) 

; to a parameter pointer 
[Store a string of SDecific length 
; to a parameter pointer 
[Store a date value to a parameter pointer 
[Store a logical value to a parameter pointer 
[Store a double-precision floating-point value 
; to a parameter pointer 

[Store an integer value to a parameter pointer 
[Store a long integer value to a parameter pointer 


EXTRN I _XALLOC:FAR [Allocate Clipper memory 

EXTRN _XFREE:FAR [Release Clipper memory previously allocated 

EXTRN _XGRAB:FAR [Allocate Clipper memory with orror generation 


These functions are used to pass values, return values (either directly or by 
storing in memory), and control memory allocation. The storing functions are 
designed primarily for storing data in predefined Clipper data arrays, elements of 
which have been passed as parameters to your assembly language subroutine. 


If you have been using Clipper through several versions, you probably noticed 
that the number of available Extcnd-System functions has increased significantly in 
Clipper 5.0 and 5.01. For most assembly language subroutines, you probably will 
use only a few of the functions, such as the functions to pass and return an integer 
(used earlier in the chapter). 
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After you get past the simple data structures (those that can be passed or 

returned in a single register). Clipper gives and expects to receive pointed to data 

This Is not unlike other high-level languages that expect data structures to b~ passed 
as pointers. »*»acu 

The hall description of what each of these functions does, and how you should 

. thC ° f lh ‘ S b °° k - Your CI ‘PP er 5 0 or 5 01 Programming 

arid Utilities manual contains all the information you should need, however. 


Summary 

Although the language Clipper uses is largely compatible with dBASE and 
FoxBase, Clipper operates differendy; assembly language routines used in Clipper 
programs must be designed with the differences in mind. 

One distinction is that in Clipper, assembly language routines can be used 
anywhere in the main program that an expression is acceptable. The interpretive 
languages -"eejuire that your routines be loaded and then called. Another major 
feature is that the CLJPPER.LJB facilities Clipper provides must be used to pass 
information into or out of your assembly language modules. 

Learning to interface with Clipper is much like learning to do so with C or with 
Pascal. After the first few practice runs, it’s easy to do. And the results are definitely 
worth the effort. 
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PartHI 


Applying 
Assembly Languag, 

Techniques 
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Working with Different 

Processors 


T f you arc writing programs for the 8088/8086 CPU. you normally don't need to 
X worry about your processor environment. All the programs in this book work on 
any member of the Intel 80x86 family. 

Each processor in the Intel family differs from the others, however Chapter 2 2 
Processor Instruction Sets,” lists these differences in detail. You mav want to w rite 

* P L^ m (OT1 $P * CifiC P rocessor —perhaps a program thal requires, al minimum 
an 80286—-or you may require the presence of a numeric coprocessor (NPX). 

This chapter covers how you detect which CPU is in the computer, as well as 
whether an NPX is present. 


Detecting the CPU Type 

Unfortunately, no special directive or instruction indicates which CPI model 
•s betng used. Instead, the programmer is left to examine the behavior of the CPU 
un er known conditions. This means that you can determine the CPU type onlv bv 

toh^° fC,i T ali0n; y ° U mUSt SCC h ° W the CPU reacls to instructions known 
to have different effects on different models. 

“ SCmb,y knguage routine presented in this section can be used to 

returTon* f F 1 * ° f CP ^ bein « used 11 is ^signed to be called from C. and w ,11 
^turn one of the values shown in (able 16.1. 


357 
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Table J6.J- Values returned by the CPU. ASM function. 


Value CPU Type 


86 

8086 

a « 

8088 

186 

80186 

18tt 

80188 

286 

80288 

386 

80386 

486 

80-»86 


The listing for CPU ASM is as follows: 

Page 60,132 
Comment J 


File: 

Author: 

Date: 

CPU.ASM 

Allen L. 

10/26/91 

Wyatt 

i 

Purpose: 

Return a value indicating 
is operating. Designed to 

the CPU on which the program 
be called from C. 

Format: 

CPU() 


i 


PUBLIC 

epu 



.MODEL 

small, C 


CPUType 

.DATA 

DW 

0000 


epu 

.CODE 

PROC 




; This first par. checks for the settin 9 of bits 1«-t 5 . Intel documentation 
; actually indicates that bits 12-15 act differently on pre-80286 .achlnes, 
; but it seems that some operatin B systems may set the general protection 
; level, mtiioh causes tne loot flag (bits 12-13, to always remain set. Th. 

; solution is to test only bits 14 - 15 . 
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DoBus: 


PUSHF 

POP 

AND 

PUSH 

POPF 

PUSHF 

POP 

AND 

CUP 

JE 

UOV 

klOV 

SHR 

CUP 

UOV 

JNE 

UOV 

CALL 

SUB 

UOV 

JUP 


AX 

A* 3FFFh 
AX 


AX 

AX,BCB0th 
AX,I , 
I286_1 

sr 

Ct,2lh 

AL.BFFh 

AL.CL . 

AL,B 

•Ax.iet 

DoBus 

AX ,88 

TestOueue 

AX.BX 

CPUType.AX 

Exit 


•‘Original flags 

;Into a workable register 

{Turn off bits 14-15 

{Put in proper register 
{Store flags 

{Qet flags back to examine 
{Only interested in bits 14-15 
{Have the bits been cleared? 
{Yes, so at least a 286 


{If AL is not cleared, then 60186 or 86188 

{Assume running 80188 

{Flag still set from previous CMP 

{Assume running 8088 

;Go check T>us width 

;BX is 0 if 188, otherwise 2 


Processor is a 286, 386, or 486 


PUSHF 


POP 

AX 

OR 

AX,4660h 

PUSH 

AX 

POPF 


PUSHF 


POP 

AX 

AND 

AX,4000h 

CUP 

AX,4000h 

JE 

I386_1 

UOV 

CPUType.266 

JMP 

Exit 


{Set bit 14 (NT flag) 

{Flag bit 14 now set 
{Store flags 

{Get flags back to examine 
{Only care about bit 14 
{Still set? 

{Yes, so at least a 386 
{No, so this is a 286 


• ti-e thi$ Ptrt i# rMChed * w ® know ** * r « working with a 32-bit 

• in *** or ‘ part * nt0 32 * bit ffi0 <*e to test whether the AC bit 

: ,1 *»* «» »• ««. If 1, C.n, „ , r , r u „„i„ a o 
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I386J : 


.386 


PUSHED 


POP 

EAX 

MOV 

EBX,EAX 

AND 

EBX,40000h 

XOR 

EAX,40000h 

PUSH 

EAX 

POPFD 


PUSHFD 


POP 

EAX 

AND 

EAX,40000h 

MOV 

CPUType,386 

CMP 

EAX,EBX 

JE 

Exit 


[Enable 306 assembly 
;Push the extended flags register 
.;Get it back Vo work with 
[Store a copy of it 
[Only care about bit 10 (AC flag) 

[Toggle AC flag (bit 10), rest stay as it 
[Stuff adjusted flags register 
[And put it in the proper place 
[Push it again 

;And back where it can be examined 
[Only want to look at bit 10 (AC flag) 
[Assume working on 386 
;If same, then we're on a 386 
;Go away now 



PUSHFD 

POP 

EAX 

[Working on 486; push flags once more 
[Work with them again 


XOR 

EAX,40000h 

[Toggle AC flag (bit 18) to original state 


PUSH 

EAX 

[Stuff adjusted flags register 


POPFD 

MOV 

CPUType,486 

[And put it in the proper place 
[And put CPU type in its place 

Exit: 

.8086 

MOV 

AX .CPUType 

[Back to default code 
[Ready to return 

cpu 

RET 

ENDP 


[Return to C 


The following routine will return with BX set to either 0 or 2. 
If it is set to 0, then the processor has an 8-bit data bus. 

If it is set to 2, then the processor has a 16-bit data bus. 


TestQueue 

PROC 

USES AX 


MOV 

BX, 1 


MOV 

AL.Testlnst 


XOR 

AL,8 


MOV 

Testlnst.AL 


NOP 



NOP 



NCP 



NOP 


Teatlnat 

OB 

„ 43h . / 


RET 


TestQueue 

ENDP 



END 



Loaa opcode for INC BX 
Change INC BX to DEC BX 
Move it back to proper place 
If using an 8-bit data bus, 

these 4 NOP instructions will 
fill the queue, allowing the 
next byte to be changed 
This is opcode for INC BX 
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The* comments included in the program liming should explain mom of the 
operations, but the\ bear c loser examination. 

/Vs you can see (ruin table 16. I. testing is done for seven processors. The first 
step in the program basically divides the group in half. It examines how the CPU 
treats the flags register to determine whether the CPU is of the pre- or post-80286 
genre According to Intel documentation, the high-order nibble (bits 12-15) of the 
flags register is always set on the 8086/8088. 80186, and 80188 chips. The 80286, 
80386, and 80186 basically leave these settings as originally set (at least in bits 
12-14). 

Because of this behavior, you should be able to clear bits 12-15, push them on 
the stack, and then—if they are set when you pop them again—you can assume that 
you are operating on one of the older processors. 

In practice, however, this may not happen. Depending on your operating 
system, or on any protected-mode programs you may have been running, bits 12 and 
13 may always be set. These bits, collectively known as the IOPL flog, indicate the 
privilege level at which the program is currently operating. 

To overcome the IOPL flag always being set, it is best to examine only bits 14 
15. If when you clear them, push the flags, and pop them, bits 14 and 15 are set. 
you can assume that you are operating on the older processors. If they are still clear, 
you arc on one of the newer processors. 

The next step differentiates between the 8086/8088 and the 80186/80188. 

| These two groups behave differently when they execute the SHR instruction. On the 
8086H088, you can shift by any value up to 255 ; the instruction will operate as 
expected. On the 80186/81088. however, you can shift by a value up to 31 only. This 
change was introduced because if you shift 16 bits by 31 bits, you still have only 0 
left as a result. Thus, shifting more than 31 limes is redundant and slows the 
operation of the processor. 

To limit the SHK value to 31. the 80186/80188 simply masks off the top three 
bits of the shift register by ANDing the value in CL with 31. This masking is done before 
the actual SHR instruction is executed. Thus, when the test shifts by 21h (33 
decimal), the result is as follows: 

00 10000 1 <—21h, 33 decimal 

0 0 0 1 1 1 1 1 <— lFh, 31 decimal 


00 000 00 1 <—Olh, 1 decimal 

) Remember that on the 8086/8088. the code simply shifts 33 times; the result 
in AL is 0. But on the 80186/80188. because the value in CL is ANDed with lFh. the 
value in AL is shifted only one place to the right .Thus, a 0 value in AL would indicate 
that the CPU was either an 8086 or an 8088. 
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The next test is clone by calling the routine at TestOueuc. This routine is used 
to determine the difference between the Hf)H6 and the H088. or between the 80186 
and the 80188 The only difference between these chips (the ones ending in 6 and 
the ones ending in 8) is the size of their data bus. The 8086 and the 80186 have a 
16-bit data bus. whereas the others have an 8-bit bus. 


Take a look at the TestOueue routine. It works correctly because it is known that 
the 16-bit machines have a 6-byte prefetch queue, whereas the 8-bit machines have 
only a -i-byte queue. This queue is used to hold the bytes following the currently 
executing instruction. Thus, if you change either byte 5 or 6 (after the current 
instruction), then you can determine whether you are using a 16-bit or an 8-bit CPU. 

Notice the odd coding in TestQueue. The byte at Testlnst is the opcode for the 
INC BX instruction. But earlier in the routine, this byte is loaded into AX and 
modified into the DEC BX instruction by XORing the byte with 08h. 

The instruction mov Testlnst ,al is used to store the modified instruction. But 
on an 8-bit CHI’, while this instruction is being executed the next 4 bytes (all the 
NOPs) are in the prefetch queue. Thus, the modified instruction can be placed in 
memory before it is fetched, and BX will be decremented to 0. 

On a 16-bit CPU. however, the prefetch queue consists of not only the NOP 
instructions, but also the original INC BX and the RET instruction. The bytes 
representing these instructions have already been fetched, pending execution, and 
any changes to memory will not affect operation. Thus, BX will be incremented 
to 2. 


VClicn the routine returns, the value in BX is subtracted from the CPU value in 
AX; AX then contains 86, 88. 186. or 188. 

So far. the routine has accounted for 4 processors. The code beginning at 
I286_t is used to differentiate between the 80286, 80386, and 80486 chips. 

The first test, which weeds out the 80286. is a flags test similar to the one at the 
beginning of the routine. It works because you can set the NT flag (bit 14) in real 
mode on the 80386 and 80486 but not on the 80286. On that chip, the NT flag is 
always set to 0 in real mode If you can set the bit and maintain it while pushing and 
popping the flags, you can assume that it is not an 80286 chip. 

Finallv^some 32-bit instructions are used to differentiate between the 80386 
and 80 - 186 . This differentiation is accomplished by checking how bit 18 of the 
extended flags is handled This is the AC (alignment check) flag; it is implemented 
on the 80-186. bu' not on the 80386. If this bit position holds a setting, vou can 
assume that you are using the 80-<86. 

That concludes the routine. All that remains is the C program (TESTCPU C) 
used to cat I II ' * 
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File: 

TESTCPU.C 

Author: 

Allen L. Wyatt 

Date: 

8/26/91 

Purpose: 

Program to test the calling of CPU<) 


^include <stdio.h> 
extern short cpu(); 
void main() 

{ unsigned short CPUType; 

CfUType = cpu(); 

printf ( \nThis is running on a %u chip\n“,CPUType); 

As you can see, this short program simply executes the function and prints the 
. value returned. 

Now let s see how to determine whether a numeric coprocessor is in your 
system. 


Detecting the Presence of an NPX 

As you have already learned from this book, there are many names for what is 
commonly called a numeric coprocessor Intel and many other sources refer to this 
chip also as the NPX (numeric-processor extension) or the FPU (floating-point unit). 

Regardless of what it is called, the NPX is the chip responsible for performing 
fast floating-point calculations and higher-math functions. Many programs require 
the use of an NPX to run. How do you determine the presence of an NPX? The 
following routine, designed to be called from C, does the trick: 

Page 60,i32 
Comment | 


File: NPX.ASM 

Author: Allen L. Wyatt 

°ate: 10/26/91 
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Purpose: 


Returns a value indicating wnether there is a numeric 
coprocessor in the system. Returns 0 if none, 1 if 
present. Designed to be called from C. 


Format: NPX() 



PUBLIC 

npx 




.MODEL 

small, C 




.DATA 




Scratch 

DW 

0000 


;Place to store status word 


.CODE 




npx 

PROC 





MOV 

SI,OFFSET 

Scratch 



MOV 

WORD PTR 

(SI],432lh 

;Initialize to nonzero 


FNINIT 



; Initialize NPX without checking for error 


FNSTSW 

(SI] 


;Get the status word 


MOV 

AX, 0 


;Assume no NPX chip 


CMP 

BYTE PTR 

(SI],0 

;Was a status value returned? 


JNE • 

Exit 


;No, so exit 


MOV 

AX, 1 


;NPX is present 

Exit: 

RET 



;Return to C 

npx 

ENDP 





END 



• 


The way this routine operates is very simple: it uses two floating-point 
instructions to determine whether the NPX is present. The FNINIT instruction 
initializes the NPX but docs not check to see whether an error occurred. (The FINIT 
instruction is the variation that checks for an error.) You do not want the routine to 
check for an error, because an error will always occur if there is no NPX. 

The next instruction stores the NPX status word at the memory location 
pointed tc by SI. Again, this version of the FSTSW instruction does not wait to see 
whether any errors occurred. If no NPX is present, no action takes place and the 
information at SI is not changed. 

If an NPX is present, the value at SI is overwritten with the NPX status word. 
The high-order byte of this status word is always 0 immediately following an 
initialization. Thus, if the byte at SI is 0, an NPX is present. 
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Note also that if you are using the 80486 chip in your system, this routine will 

indicate t e presence of the numeric coprocessor because the functionality of the 
NPX is built into the 80486. 7 

lo test this routine, use the following C program: 

/• File: TESTNPX.C 

• Author'': Allen L. Wyatt 

• Date: 6/26/91 

• Purpose: Program to test the calling of NPX() 

*/ 

•include <stdio.h> ' 
extern short npx(); 
void main() 

< unsigned short GotNPX; 

GotNPX = npx(); 
switch (GotNPX) 

{ case 6: 

printf(*\nA numeric coprocessor is missing\n*); 
break; 
case 1: 

printf(*\nA numeric coprocessor is present\n* >; 
break; 
default: 

printf(‘\nUnknown value returned: %u\n*.GotNPX); 

' ) 

> 

This program calls the assembly language routine and, based on the value 
returned, indicates whether an NFX is present. 


Summary 

This chapter has presented some short but very useful subroutines that can 
help you understand your processing environment. With these routines, you can 
determine what type of CPU you are using and find out whether there is a numeric 
coprocessor. 
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Once you have (his information, you can alter your program s execution 
accordingly or issue warnings or errors to the user to indicate that the environment 
is not satisfactory. 

In the next chapter, you will learn how to take advantage of your computer s 
video system. 


Scanned by CamScanner 




Video Memory 



VVT-riting information to a video display monitor is perhaps the biggest bottleneck 

VV in most high-level languages. The sad thing is, most programmers do not even 
realize lhat it is a bottleneck. 


The video display is simply a representation of what is contained in a specific 
area of memory. This type of display is referred to as a memory-mapped display; the 
display memory area is called a video buffer because it holds what will he displayed 
on the monitor. Changes occur constantly in the video buffer, and affect what is seen 
on the video display. The buffer’s location in memory depends on the type ol display 
adapter being used. A discussion of the buffer’s location is included in this chapter’s 
description of each display-adapter type. 

The original displays for the PC used an 80-column, 25-line screen, l-ach text 
screen’s video buffer occupied 4,000 bytes (OI-AOh) of data. Mow was this number 
derived? I: ich character position on the screen uses two bytes of memory—one for 
the character and one for the character’s attribute. The attribute byte controls how 
the character will be displayed (in color, with underlining, blinking, and so on). 
Thus, one text screen required 4,000 bytes (80 x 25 x 2) of memory. 

** ilh lhe introduction of the liGA, and later the MCGA and VGA, display 
capabilities became a bit more complex. With these advanced video adapter cards, 
you canextend the number of columns on each line to 132, and the number of lines 

per screen to 60. Doing so raises the buffer size requirement from 4,000 to 15,8-iO 
bytes. 


You can display individual characters or strings by using certain BIOS and DOS 

interrupts, but they tend to be rather slow You can use BIOS and DOS functions to 
Rain some (but not much) speed advantage over high-level language display 
techniques. You do not gain much of an advantage because, to guarantee portability 
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.. . , , languages ordinarily use the DIOS and IX)S 

l^ry rouiines. ^ ^ ^ |hcy 

maintain .he unacceptable For example, in 

display operations so much t y rou(ines , he individual routines that make 

more than one Instance In the B O necessar y information for completing the 

up (NT lOh call themselves to determ popping, and overhead than if the 

current task. This results In much morc pu h ng^pp £ ^ p( . m()dc|s , wjth 

Video routines had the Original 4 77 MHz speed, the delays 

become^much less notable but are nonetheless time consuming 
Because a video display Is simply a 

you can alter the display by altenng thati me ry ^ |0 mother. By using the 

transfer large blocks of memory qui y following subroutine to transfer 

^:r:^^^^ aa “ lnumberrf 

clock cycle* depends on your CPU version.) 

OVE.BLOCK PROC NEAR^ ^ pR ;Save all used registers 

{Image data to be moved 
{Segment of video buffer 
{Start at beginning of buffer 
{Size of video screen 
{Move it 


move_block 

‘stated in dock cycles, this may sound like a long time for transferring dan. 
S ° mU c, remember that on a standard IBM PC running at 4.772727 MHz, 
""•SSU b only 0.0000002095238 seconds; therefore, the entire process 

takesappiwimately 0.01678.41)- seconds The speed increases significanJy on faste 

machines. 

No matter which machine vou use, an entire screen can be displayed in less 
than 1/50 of a second, which is virtually instantaneous (Refresh times on televisi 
screens are only l/60of a second.) Compare that to a high-level language and th 7 

you have to clear the screen and then move data elements individually to the sc 

For those of us who use high-level languages, the capability crfdispto yltiglht nBk 
instantaneously on-screen is one of the attractions of u..ing assembly la g g 


PR0C 

NEAR 

USES 

to 

Ui 

Q 

M 

</> 

X 

o 

MOV 

SI,OFFSET S0URCE_DAT 

MOV 

ES,VI0E0_BUFFER 

MOV 

OI.B 

MOV 

CX,0FA0h 

REP 

M0VSB 

RET 


ENOP 
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“ mem h °^ d T ndS Which ^ 

used on IBM microcomputers. «am.ne the display adapters commonly 


Differences between 
Display Adapters 

The IBM family of personal computers (and major clones) uses a variety of 

25*7^ ha - been around for years, and new ones crop up 
periodically. In this section. I discuss the methods and conventions used to display 
information on the six most popular display devices: 


□ The IBM Monochrome Display Adapter (MDA) 

□ The Hercules Graphics Adapter (HGA), which includes a monochrome 
graphics capability 


□ The IBM Color Graphics Adapter (CGA) 

□ The IBM Enhanced Graphics Adapter (EGA) 

□ The IBM Multi-Color Graphics Array (MCGA) 

□ The IBM Video Graphics Array (VGA) 

I also mention briefly the newer super VGA (SVGA) cards, although there is no 
clear standard among them. € 

The way you program your application depends largely on. which display 
device you use. You should do some advance research to ensure that you know 
wh.ch device(s) you will use. If several display types are likely to be used, you can 
program your software to make intelligent choices about which ty pe of display is 
currently in use. You will learn about one such method later in this chapter. 

AJ 1 these display adapters (except the MDA) can display true graphics data. As 
I will h- ,n 1 c ,ntroducl,on - 1 w ' 11 n °t delve into specific graphics routines. Rather, 
data ISCUSS 1 e ^ in w h»ch each type of display adapter stores and displays textual 


The Monochrome Display Adapter (MDA) 

The IBM Monochrome Display Adapter made its debut when the IBM Personal 
omputer was introduced in 1981. As the name implies, the MDA displays informa¬ 
tion in monochrome (one color). Which color depends on the type of monitor you 
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have . Most monochrome monitor display data in either green or amber, although 
other colors can be displayed. 

The MDA offers a resolution of 720 by 350 pixels-a total of 252,000 picture 
dements This total is segmented into 2,000 character cells (each w„h a resolution 
Of 9 by 14 pixels) arranged in 25 rows of 80 cells each. 

The- contents of each character cell are stored In memory as a single byte of 
information Each character cell has a corresponding attnbute byte that «mirolsihe 
way in which the character is displayed. The composition and use of the attribute 
byte are discussed later in this chapter. 

The video buffer used by the MDA holds a single text screen and consists of 4K 
of RAM, beginning at BOOOOh (segment address B000:0000). The characters and 
their attribute bytes are interlaced so that the video memory Is mapped beginning 
at the upper left comer of the screen and proceeding across and down the display 

(see table 17.1). 


Table 1 7. 1. Memory focations for MDA display data. 


Segment Address 

B00u:0000 
B000:0001 
B000:0002 

B000:0003 

B000:0004 

B000:0005 

B000:009C 

BOO0:OO9D 

B000:009E 

B000:009F 

BOOO:OOAO 

B000:00A1 

BOOOOOA2 

B000:00A3 

BOOOOEFC 

BOOO;OEFD 

B000:0EFE 

B000:0EFF 

B000 0F00 


Character/Attribute 

Character for row 1, column 1 
Attribute for row 1, column 1 
Character for row 1, column 2 
Attribute for row 1, column 2 
Character for row 1, column 3 
Attribute for row 1, column 3 
Character for row 1, column 79 
Attribute for row 1, column 79 
Character for row 1, column 80 
Attribute for row 1, column 80 
Character for row 2, column 1 
Attribute for row 2, column 1 
Character for row 2, column 2 
Attribute for row 2, column 2 
Character for row 24, column 79 
Attribute for row 24, column 79 
Character for row 24, column 80 
Attribute for row 24, column 80 
Character for row 25, column 1 




0 - 
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Segment Address 

BOOOOFOI 

B000 0F02 

B000:0F03 

B000:0F9C 

BOOO:OF9D 

B000.0F9E 

B000.0F9F 


Cburacter/A ttribute 

Attribute for row 25, column 1 
Character for row 25, column 2 
.Attribute for row 25, column 2 
Character for row 25, column 79 
Attribute for row 25, column 79 
Character for row 25, column 80 
Attribute for row 25, column 80 


l ain* m!*! c ^ aracter ' < ** s,,la y P°*lll°n can contain a value of 1 through 256. with each 

.».^ Charac,ercodeusrdbyMDA 

ftg. 17.1. ASCII character code for MDA 




224:cr 

IZizp 

\2i-.r 

!27:| 

!28:I 

(2*:r 

:3fcj> 

31=T 

32:| 

33:5 

34:8 

35:4 

36:« 

37:# 
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r 17 1 arc created by an HK character 
The chance, cooes a chancer, simply place .he 

sr,“ "»“ S5 

of the MDA takes care of the rest. 

The Hercules Graphics Adapter (HGA) 

formonochromegraph.es. except that the HGA 

Ordinarily, the HGA behaves <£^tly, ‘ b u-mappcd graphics mode, the HGA 

indudesa monochrome graphics capabil^ry ^ &I IGA operates exactly 

provides a resolution o - . fer 10 the section on the MDA.) 

like the MDA (For additional informal,on. refer lo tne 

The Color Graphics Adapter (CGA) 

IBM’s first offering for color graphics capability on dre^BM family of microcom- 

puters. the Color on "hedisp'layclricxtua 1 data because, as I stated 

mtheTnnodu^n. the b, .mapped graphics mode is beyond .he scope of this boo^ 

The high resolution offered by .he CGA is 6-fO by 200 pixels, a toudof lW», 
a-i. merits As with the MDA. this total can be segmented into 2,000 ch 
P ‘n IUrc in 25 ^ of either so or 80 cells each But the resolution of each cell 

i"ssignificandy less with the CGA^mly 8 by 8 pixels, which renders chancers less 
readable and crisp than those on the MDA. 

In text mode, the CGA functions much like the MDA. This Is u'ldcrsLandablr-' 
the CGA and MDA both use the Motorola 6845 CRT Controller chip. With the CGA 
aswith dteMDA, the coments of each chancer cel. are stored in memory,I £ 
byte of information. Each character cell has a correspond,ng attribute r byt* 
controls how the character is displayed The composition and use of the attnb 
byte is different in the CGA and the MDA. as you will learn later in this chaptc 

The video buffer used by the CGA consists oft 6K of RAM, beginning at 
(segment address B800 0000) Because a 40 by 25 text screen requires only ^ 
memory, the video buffer can hold as many as 8 text screens, or pages. Wltn » ^ 
by 25 text screen, which requires 4K of memory, as many as 4 video pages c 
contained in the video buffer. 


_ <fe, 
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the buffer start addrcssusld^^th^^f^ CRTC seuopolnt 

* 7 ?,** MD *- * e cbl "“ “<< their attribuce by.es are Interfaced, 

STkl^? P t T' r0f ' he ” C '" lnd Proving acrou and down dte 
displa y. Table 17.2 shows how the video memory for the first page of an 80 by 25 
screen is mapped. 


Table 17.2. Memory locations for first page of an 80 by 25 CGA. 

Segment Address 

Character/Attribute 

B8000000 

Character for row 1, column I 

B800:0001 

Attribute for row 1, column 1 

B800:0002 

Character for row 1, column 2 

B800:0003 

Attribute for row 1, column 2 

B800:0004 

Character for row 1, column 3 

B8000005 

Attribute for row 1, column 3 

B800 009C 

Character for row 1, column 79 

B800009D 

Attribute for row 1, column 79 

B800009E 

Character for row 1, column 80 

8800:009**' 

Attribute for row 1, column 80 

B80000AO 

Character for row 2, column 1 

B800 00A1 

Attribute for row 2, column 1 

B800:00A2 

Character for row 2, column 2 

B80000A3 

Attribute for row 2, column 2 

B800:0EFC 

Character for row 24, column 79 

B800:0EFD 

Attribute for row 24, column 79 

B800.0EFE 

Character for row 24, column 80 

B8000EFF 

Attribute for row 24, column 80 

B800 0FOO 

Character for row 25. column 1 

B800 0F01 

Attribute for row 25, column 1 

B8000F02 

Character for row 25, column 2 

B800 0F03 ' 

Attribute for row 25, column 2 

B8000F9C 

Character for row 25, column 79 

B800:0F9D 

Attribute for row 25, column 79 

B800:0F9E 

Character for row 25, column 80 

B800:0F9F 

Attribute for row 25, column 80 
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Each character-display pwition can ^” t ^ 1 * codestlscd bytbe CGA 

«,uc equivalent lo a ^^a^ a"of ASCI, The CGA uses 

arc the same as those used by the MIM, ana arc * » k- 

a ROM character generator also. 


The Enhanced Graphics Adapter (EGA) 


IBM introduced the Enhanced Graphics Adapter in late 1 
there are several noticeable differences between the EGA and the Color Graph cs 
Adapter. The following advantages are available with an EGA card: 


□ More colors can be displayed 

□ Text Information, displayed in color, can blink 

□ Resolution is Improved 

□ More display modes are avanaole 

□ User-defined character sets are available 

Before proceeding, let’s examine this last point. As you can see from table 17.3, 
the EGA offers 12 display modes. 


Notice that the resolution offered by the EGA is not quite as good as that offered 
by the MDA and HGA boards. EGA resolution is 640 by 350 pixels*—a total of224,000 
picture elements. 

The possibilities of using this resolution in a color graphics mode are quite 
impressive, but these capabilities are beyond the scope of this book. Because 
describing how to use the EGA effectively would fill an entire book, 1 focus only on 
using the EGA in text mode. 


Like the other video adapters, the EGA normally segments the text screen into 
2,000 character cells, each with a resolution of 8 by 14 pixels. These character cells 
are arranged in 25 rows of 80 cells each. THe contents of each character cell are stored 
in memory as a single byte of information. Each character cell has a corresponding 
attribute byte that controls how the character is displayed. (The composition and use 
of the attribute byte are discussed later in this chapter.) 

The EGA provides a capability for loading user-specified character sets, 
however, and when you load the 8-by-8-pixel ROM set normally used only with 
40-column graphics modes, the number of rows of text rises from 25 to 431 This in 
turn increases the size of the video buffer to 6,880 bytes (3,440 characters, plus the 
same number of attribute bytes). 
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Mode 

Number 

Mode 

Type 

Display 

Type 

Pixel 

Resolution 

Characters 

Box • 
Size 

Colors 

0 

Text 

Color 

320 x 200 

40x25 

6x8 

16 


Enha'nced 

320 x 350 

40x25 

8x14 

16/64 


1 


— 

- Same as mode 0- 



2 

Text 

Color 

640x200 

80x25 

8x8 

16 

* 

Enhanced 

640 x 350 

80x25 

8x14 

16/64 


3 



- Same as mode 2- 

_ 


4 

Graph 

Clr/Enh 

320 x 200 

40x25 

8x8 

4 

5 



- Same as mode 4- 

— 


6 

Graph 

Clr/Enh 

640 x 200 

80x25 

8x14 

2 

7 

Text 

Mono 

720 x 350 

80x25 

9x 14 

4 

13 

Graph 

Clr/Enh 

320 x 200 

40x25 

8x8 

16 

14 

Graph 

Clr/Enh 

640 x 200 

80x25 

8x8 

16 

, » 

Graph 

Mono 

640 x 350 

80x25 

8x 14 

4 

16 

Graph 

Enhanced 

640 x 350 

80x25 

8 x 14 

varies 


Which video buffer is used by the EGA depends on the amount of memory 
available on the card. Most of the higher memory capabilities are used only in 
multi page graphics software or in animation. In text mode, however, the EGA is 
capable of emulating either the MDA or CGA in memory usige. If connected to a 
monochrome monitor, the video buffer begins at absolute address BOOOOh (seg¬ 
ment address B000:0000), a* does the MDA. If connected to a color monitor, the 
video buffer begins at absolute address B8000h (segment address B800:0000), as 
does the CGA. 

As with other text screens, the characters and their attribute bytes are inter¬ 
laced so that, beginning at the upper left comer of the screen and proceeding across 
and down the display, the video memory is mapped as shown in table 17.4. The 
question mark is replaced by 0 if the EGA is connected to a monochrome monitor, 
and by 8 if connected to a color monitor. 

The EGA can display the same character set that each of the other display 
adapters can display, but the rharacters are displayed differently. The EGA uses a 
RAM character generator, not one that is ROM-based. This means that you can design 
and download custom fonts based on your own needsrAs many as four fonts of 256 
c haracters each can be developed and subsequently used by the EGA, but only two 
of the fonts can be used at any given time. Detailed information on the development 
and use of alternate fonts is beyond the scope of this book. 

A 
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Assembly language .ecnniqu^ 


Table 17.4. Memory 
S egment Address 

B?00:0000 
B?00:0001 
B?00:0002 
B?00:0003 
B?00:0004 
B?00:0005 
B?00:009C 
B?00:009D 
B?00:009E 
B?00:009F 
B?00:00A0 
B?00:00A1 
B?00:00A2 
B?00:00A3 
B?00:0EFC 
B?00:0EFD 
B?00:0EFE 
B?00:0F.FF 
B?00:0F00 
B?00:0F0l 
B?00:0F02 
B?00:0F03 
B?00:OF9C 
B?00:0F9D 
B?00:0F9E 
B?00:OF9F 


locations for EGA display data 

Cbarac ler/Attributc 

Character for row 1, column 1 
Attribute for row 1, column 1 
Character for row 1, column 2 
Attribute for row 1, column 2 
Character for row 1, column 3 
Attribute for row 1, column 3 
Character for row 1, column 79 
Attribute for row 1 column 79 
Character for row 1, column 80 
Attribute for row 1, column 80 
Character for row 2, column 1 
Attribute for row 2, column 1 
Character for row 2, column 2 
Attribute for row 2, column 2 
Character for row 24, column 79 
Attribute for row 24, column 79 
Character for row 24, column 80 
Attribute for row 24, column 80 
Character for row 25, column 1 
Attribute for row 25, column 1 
Character for row 25, column 2 
Attribute for row 25, column 2 
Character for row 25, column 79 
Attribute for row 25, column 79 
Character for row 25, column 80 
Attribute for row 25, column 80 


The Multi-Color Graphics Array (MCGA) 

When the PS/2 line was introduced, IBM moved the video-adapter functions 
from the traditional separate card onto the system motherboard and changed the 
name from “adapter" to “array." 
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IBM also produced two different kinds of graphics arrays, one for the “low end” 
of the line (Models 25 and 30) and another for the rest of the PS/2 line. 

1 he low-end device is the Multi-Color Graphics Array, which replaces the 
CGA and offers vastly improved performance. Resolution was increased to 640 by 
480 pixels, and the number of colors MCG A can display is limited only by the quality 
of the attached monitor. In graphics mode, MCGA can display any 256 colors from 
a range of more than 262,000 hues, in 320 by 200 resolution. In text mode, MCGA’s 
performance is similar to that of the high-end device, the VGA (discussed in the next 
section), except that MCGA's vertical resolution is limited to 350 scan lines. 


The Video Graphics Array (VGA) 

The Video Graphics Array—the “high-end” device for the PS/2 line of IBM 
systems—is'available also as an adapter card for other IBM-compatible PCs and 
clones. The prices of VGA adapters have decreased so much that the VGA has be¬ 
come the default card-of-choice for color graphics systems. 

The VGA offers all the capabilities of the MCGA (and more) in graphics modes, 
but increases resolution up to 720 by 400 pixels in text modes, whereas the MCGA 
goes only to 640 by 350. 

Like the EGA'both the MCGA and the VGA can be loaded with user-defined 
fonts. The VGA also gives you the choice of 200-line, 350-line, or 400-line vertical 
resolution, a choice that gives you an even wider range of possible buffer sizes 
because you can have as many as 60 rows of text on a single screen. The most 
common choices, however, are either 25 rows (the conventional 8-by-l6-character 
box at 400 lines) or 50 rows (an 8-by-tt box at 400 lines). 

If you will be using an MCGA or VGA with a screen that is not the conventional 
25-line size, you may not be able to use the exact code developed In this chapter; you 
can easily modify the code to work properly with any screen size you choose, 
however, by changing the portions that convert row and column counts. 

Like the EGA. both the MCGA and the VGA automatically map their text-buffer 
memory addresses to either the BOOOh or B800h range, depending on whether a 
monochrome or color monitor is connected. As long as you stick to the 80-by-25 
screen dimensions, you can use the same assembly language routines to deal.with 
all the displays available. 


Super VGA Cards (SVGA) 

The newest entries in the mass-market video-card arena are members of the 
super VGA classification. These cards offer much higher resolution and color 
capabilities than VGA cards, and can really enhance the use of certain programs. 
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. Li„ m wir k these cards is chat no clear standard as to what 
The only problem VGA is simply a dassifica.ion for any 

constitutes supor^fGA ex ^^^ £ards .hesecardsmay 

b^compabbfa individually with the VGA (they allow the same video modes as the 
VGA) there is no clear plan on how to use the "super modes. 

How do the card manufacturers overcome this problem? E«y-<hO' ‘""P* 
create video drivers for such popular software as Windows or AutoCAD and bund e 

the drivers with their product. 


Unfortunately, the programmer who wants to take advantage of these cards 
must program to the individual product. Thus, programs you write for one super 
VGA card may not work with a different super VGA card. 


Determining the Type 
of Display Installed 

Because the type of display adapter installed determines the way text is 
displayed, your first task is to have your program determine what type of adapter is 
installed in the computer. To communicate with the peripherals attached to it, the 
computer must know what those peripherals are—including the display adapters. 

BIOS cannot display information unless it knows what type of display adapter 
currently is being used. BIOS keeps a list of video-related information, beginning at 
memory locations 0449h through 0489h (see table 17.5). 

Currently, two of the memory locations showq in table 17.5 are of interest. The 
byte at 0410h tells what the system-board switch settings were when the POST 
(Power-On Self Test) was performed at booting. Each bit of u»e word denotes a 
different setting. Table 17.6 shows tfie bit meanings of the value at 0410h. 

The value of bits 5-4 tells you what type of card (color or monochrome) is 
installed, according to the system-board dip-switch settings. But you can't tell 
. whether the monochrome board is an MDA or HGA or whether the color board is 
a CGA or EGA. ( The distinction is not germane to this discussion, however, because 
we are dealing only with textual display of data.) A monochrome adapter, such as 
the MDA, the HGA, or the EGA, MCGA, or VGA in monochrome mode, a video 

buffer starting at BOOOOh; a color adapter, such as the CGA, or EGA, MCGA, or VGA 
in a text color mode, uses a video buffer starting at B8000h. 
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Table 17.5 • BIOS video-related data. 


Memory Location 

Length 

Purpose 

0410h 

Byte 

POST equipment list 1 

041 lh 

Byte 

POST equipment list 2 

0449h 

Byte 

BIOS video mode 

044Ah 

Word 

Columns 

044Ch 

Word 

Page length 

044Eh 

Word 

Page beginning 

0460h 

Word 

Cursor s tart/end 

0462H 

Byte 

Page number 

0463h , 

Word 

Current adapter base port 

0465h 

Byte 

Mode selection 

0466h 

Byte 

Palette 

0484h 

Byte 

Rows (EGA / MCGA/VGA only) 

0485h 

Byte 

Points (EGA/MCGA/VGA only) 


Table 17.6. Meaning of bits at memory location 0410b. 


Bits Meaning of Bits 

76543210 


00 

1 disk drive installed, if bit 0 s 1 

01 

2 disk drives installed, if bit 0= 1 

10 

3 disk drives Installed, if bit 0=1 

11 

4 disk drives installed, if bit 0=1 

01 

Initial video mode is color, 40 by 25 

10 

Initial video mode is color, 80 by 25 

11 

Initial video mode is monochrome, 80 by 25 

00 

64K system board RAM installed 

01 

128K system board RAM installed 

10 

192K system board RAM installed 

11 

256K system board RAM installed 

0 

Math coprocessor not Installed (AT only) 

1 

Math coprocessor installed (AT only) 

0 

No disk drives installed 

1 

Disk drives installed, see bits 7-6 
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The other memory location of interest is 0463h, which provides the adapter s 
base-port address, which can be either of two values (see table 17.7). 

Table 17.7. Adapter base port values stored at 0463b. _ ’ 


Adapter Base Port 


MDA 

03B4h 

HGA 

03B4h 

CGA 

03D4h 

EGA 

03D4h 

MCGA 

03D4h 

VGA 

03D4h 


Notice that the same values are stored at 0463h for the MDA/HGA and the 
CGA/EGA/MCGA/VGA. This information tells you which class of adapter is being 
used. Color-capable adapters have a base-port address of 03D4h, whereas mono¬ 
chrome adapters have a base-port address of 03B4h. Coupled with the data obtained 
from memory location 04l0h (whether the computer is in monochrome or color 
mode), you easily andsafely can assume which type of monitor the computer is 
using. It may seem that you need only one of these items to tell the monitor type; 
but what if you are using a monochrome monitor connected to a VGA? For some 
peripherals, you need to know the type of card as well as the type of monitor. 

Now, let’s use this information in a subroutine to determine the segment 
address that should be used for display of textual information. This routine is a 
“buildingblock" that will be called by other (still to be developed) assembly language 
subroutines: 

Page 60,132 
Comment { 


Tile: FINOCARD.ASM 

Author: Allen L. Wyatt 

Oate: 9/6/91 

Purpose: Determine the type of video card installed, and save info. 

This routine is designed to be called from other assembly 

language routines, but also needs to work within the BASIC 
memory model. 
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PUBLIC FindCard 
PUBLIC MonitorAddr 
PUBLIC StatusPort 

.MODEL medium.BASIC 

MONO EQU 0B0Q0h 

COLOR EQU 0B800h 

.DATA 

Monitor_Addr DW 0000 

Status_Port DW 0000 


.CODE 

FindCard PROC USES BX DX ES 

MOV BX,0040h 

MOV ES.BX 

MOV DX,ES:63h 

ADD DX,6 

MOV Status_Port,DX 

MOV Monit o r_Add r,COLOR 

MOV BX,ES:10h 

' AND BX,30h 

CMP BX.30h 

JNE NotMono 

MOV Monltor_Addr,MONO 

NotMono: RET 

FindCard ENOP 

END 


This routine 

Data for other routines 


;Mono video buffer start 
; Color video buffer start 


;Offset of video buffer 
;Address of card status port 


Store registers used in this routine 

Look at base-port value 
03B4h * monochrome 
03D4h * color 

Point to cards status port 
Save the status port 

Default to color card 
Get equipment list 
Only want bits 5-4 
Is it monochrome (bits a 11)7 
No, so keep, as color 
Yes, set for monochrome 

Return to caller 


At the conclusion of inis routine, the address of the display adapter* s status port 
is saved in STATUS_PORT, and the segment offset for the video buffer Is stored in 
MONITOR_ADOR. These variables are declared PUBLIC so that they can be used by the 
routine that actually moves a character of data to the video buffer. (Soon you will find 
out why determining the adapter’s status-port location is important.) 
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Displaying a Character 
in Video Memory 

The next task is to develop a routine to move a character directly into video 
memory. You may remember that the IBM family of computers uses a memory, 
mapped video display. Consequently, changing the video memory results in a 

display change. 

You can move data directly into the video buffer area, but doing so may result 
in an undesirable side effect of “snow” or glitches on the screen. This effect, 
particularly objectionable on the original IBM CGA design in text color mode and In 
all truly faithful clones of that adapter, is caused by accessing the video memory at 
a time that conflicts with other demands placed on it. 

All the IBM display adapters are based on the Motorola 6845 CRT Controller 
chip. The chip used in the EGA is different, but is also based on the 6845. This chip 
controls the video RAM buffer area. When conventional memory chips make up the 
video buffer, they can be accessed by only one other device at a time. If you try to read 
from or write to them at the same time that the 6845 is trying to read them for display, 
you will momentarily block the 68 i 5 from accessing the RAM. That interference is 
visible on the CRT as multicolored snow. 

Because the effect was well known by the time the EGA was designed, the EGA’s 
controller prevents snow from occurring. The MCGA and VGA also are snow-free. 
Even a few CGA designs avoided the problem by including more expensive dual- 
ported memory chips. But most CGA designs faithfully mimic the original version, 
including its susceptibility to interference and snow. 

To compensate for this potential conflict, a routine must verify that a character 
is deposited only when the 6845 is not reading video memory. This “safe” time 
occurs during what is referred to as a horizontal retrace condition (HRQ. While this 
condition is in effect, depositing a character in a video memory location does not 
result in interference. 

The adapter card’s status port contains information about the current state of 
the 6845. One factor that can be determined by reading this port is whether the 
adapter is currently in a horizontal retrace condition. If bit 0 is set to 0, the 6845 has 
video enabled and b accessing memory. If bit 0 is set to 1, a horizontal retrace 
condition exbts and video memory b not being accessed. 

The time available is extremely short; you can move only one 1 6-bit word— one 
character and its accompanying attribute—Into the buffer during a single HRC time. 

To display a single character without causing a conflict, you must write a low- 
level routine such as PCIIAR Remember iha' the following b a low-level routine, 
designed to be called from other assembly language routines: 
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Comment | 


File: 

PCHAR.ASM 

Author: 

Allen L. Wyatt 

Date: 

9/11/91 

Purpoae: 

To print a character on the video screen. 

Format: 

AL ■ ASCII value of character to print 

• 

DI • video buffer offset at which to place AL 


PUBLIC 

PCHAR 

EXTRN 

Monitor_Addr:WORD 

EXTRN 

Status_Port:WORD 

.MODEL 

medium, BASIC 

.CODE 



PCHAR PROC 

USES DX ES 

.Store registers used in this routine 

MOV 

ES,Monitor_Addr 


MOV 

OX,Status_Port 


CL1 


;Don't allow Interrupts 

PUSH 

AX 

;Store the character 

Retrace: IN 

AL.DX 

;Get card status 

TEST 

AL, 1 

;Are we in a retrace state? 

JNZ 

Retrace 

;Yes, so check again 

* 


;0n fall through, just 
; exited retrace state 

No_Retrace; IN 

AL,DX 

;Get card status 

TEST 

AL, 1 

;Are we in a retrace state? 

JZ 

No_Retrace 

;No, so check again 
;0n fall-through, just 



; entered retrace state 

POP 

AX 

;Yes, get character back 

MOV 

ES: (DI ] ,AL 

;0K to write it now 

STI 


;0K to have interrupts now 
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INC 

INC 


DI 

01 


;Point to attribute 
;Next screen location 


RET 

PCHAR ENDP 

ENO 

Notice that the 6845 status port is read in two separate loops. The first, Retrace, 
tests bit 0 to determine whether an HRC currently exists. If bit 0 is equal to 1, the zero 
flag will be clear, and the JNZ is executed to check again for an HRC. The loop is exited 
only when the HRC does not exist. This may sound backwards, because 1 pointed 
out earlier that accessing video memory during the retrace is safe. It is safe, but 
the instructions to pop the character from the stack and deposit it in video memory 
take time—the HRC could be over by the time the character is deposited. 

When this routine is entered, you have no idea how long the HRC has been in 
effect or when it will end. Thus, the first loop waits until any existing HRC is 
completed The second loop waits for an HRC and then accesses the memory at the 
start of the HRC. The result is the least possible snow. 

Hardware interrupts are disabled (CLI) at entry to this routine and then 
enabled again (ST I) just after storing the byte in video RAM This is necessary; 
without these instructions, a lengthy hardware interrupt might occur just as the 
routine decided that accessing the video buffer was safe, and the HRC would be over 
long before the interrupt returned control to PCHAR. After the character has been 
stored, interrupts can be tolerated. Whenever you need to disable hardware 
interrupts to meet strict time requirements, be sure to enable the interrupts as soon 
as you can safely do so. 

After verifying that an HRC has begun, PCHAR places a character at the video- 
buffer offset position determined by Dl The following section shows how to 
determine the value of Dl from simple X-Y coordinates. 

PCHAR returns with all registers (except Dl. intact. Dl is incremented to point 
at the next character position in the video buffer. After completion of this routine, 
you can develop a routine (that can be called from a high-level language) to display 
a string of ASCII characters instantly at any position on the screen. 


Displaying an ASCII String 

You now know what type of display adapter is installed, you have saved the 
segment address of the video buffer, and you know how to display a single character. 
All that remains is to determine the correct offset address so that you know where 
to begin displaying information. 
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^ From the details presented earlier in this chapter, yon can easily derive 
formula for determining the ofTset for displaying a character a. any given location 
th<* rcreen. This formula can be expressed as 


a 
on 


| (ROW-1) • 80 + (COLUMN-1) ) • 2 

In this equation, ROW is assumed to be in the range of 1 through 25, and 
COLUMN is assumed to be in the range of 1 through 80. (If you change the number 
of rows when using an EGA, MCGA, or VGA, these formulas must change accord- 

ingly!) The offset for the attribute of any given character can be located by the 
formula 

[(ROW-1) * 80 + (COLUMN-1) | * 2 + 1 

Notice that the character addresses are always even, whereas the attribute 
addresses are always odd. 

All you need to calculate the memory offset are the X (COLUMN) and Y (ROW) 
coordinates. Using this equation and the routines developed in the two preceding 
sections, you can write a routine that displays a string at any given position on *.he 
text screen. The following routine, which is called from QuickBASIC, will perform 
this task: 


Page 65,132 
Comment 2 


File: PSTRING.ASM 

Author: Allen L. Wyatt 

Date: 9/11/91 

Purpose: To display a stti.tg directly to video memory from 
QuickBASIC. 

Format: CALL PString(A$,X\,Y*) 

A$: The BASIC string to be displayed. 

X*: The integer colum value. 

YV The integer row value. 


PUBLIC PString 

EXTRN FindCa:J:FAR 
EXTRN PCHARtFAR 
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.MOOEL medium, BASIC 
.COOE 

PString PROC String, Column, RowrWORD 


CALL 

FlndCard 

;Locate the video buffer 

ftiOV 

BX,String 

;0et BASIC's string pointer 

MOV 

CX.IBX] 

;0et the string's length 

JCXZ 

Exit 

;No length, so don't print 

MOV 

SI,(BX+2) 

;SI points to string 

MOV 

BX,Row 

;Get address for row 

MOV 

AX.IBXl 

;Get row value 

DEC 

AX 

;Put as a zero offset 

MOV 

BX,Column 

;Get address for column 

MOV 

DI,(BX] 

;Get column value 

DEC 

01 

;Put is zero offset 

MOV 

BX ,80 

;80 characters/row 

MUL 

BX 

;Now have rows in AX 

ADO 

01,AX 

;Add to column number 

SHL 

01,1 

;Multiply by 2, Dl^offset 

PSLOOP: MOV 

AL.ISI] 

;Get the string character 

INC 

SI 

;Point to the next character 

CALL 

PCHAR 

;No, so print the character 

LOOP 

PSLOOP 

;Redo for length of string 


Exit: RET 

PString ENDP 

ENO 

When you pass parameters from QuickBASIC to this routine, remember that 
the X*Y coordinates must be integer values. If integers are not used, unpredictable 
results may occur. 


Using the Attribute Byte 

iou may recall that each displayed character in the video buffer requires two 
bytes of information—the ASCII value of the character and the character’s display 
attribute. 
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able 17. 8. Meaning^ of tbe bits in g monoc hrome attribute byte. 
76M321 e Meaning of Bit Setting 


0 

1 


000 

111 


0 

1 


001 

111 


Nonblinking character 
Blinking character 
Black background (normal) 
White foreground (inverse) 
Normal intensity 
High intensity 

Underlined white foreground 
White foreground (normal) 
Black foreground (inverse) 



bbb 


ffff 


Normal foreground 
Blinking foreground 
Background (see table 17.10) 
Foreground (see table 17.10) 


/ 


This attribute byte controls how the rh, 
attribute byte has a d^erem funct.on RcaL^T^ d “P u >«i Each bit of the 
are using, the purpose of each bi, is the s™. T t 2 1 * ° f <Uspla >’ ada P*« *»* 
settings varies according to the ope of adap^ * C ^ produred b > r different 

background TTicforeground^ThTch'^r^^^cc' wt ’ e ' t “ bits ^ control the 
character ceU surrounding the character Ahh baCkground “ the area of the 

way on both color and rnonochmm a ' ^ though bits used in the same 
Table 17.8 lists the rn^n^T ** ^ °" ** ■*!>*«. differs, 

attribute byte on a monochrome P ° SS ' C Sertmgs of bits ^ each character’s 
for attribute bytes on a color monitor' 0 * ^ * 1?9 shows thc samc infon nation 


(0-7) can he 17 10 thatwiththccolorattrib ute, only the first 8 colors 

foreground ** background valucs > whcrcas ^ 16 colors can be used for 

When y° u usc tbc monochrome and color attributes, certain 
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Pan 111: AppjyjW 




. i haekcround result in invisible characters, 
combinations of foreground and * huma ns. , hey are valid to the com- 

(AlthougMnvlsible^characteR^are u^ combinations , hat you find pleasing for 

different applications. u brigh , foregrounds, if you are 

YOU can have bright backgrounds, fo nd color blink. The method 

willing to give UP the blin \ control to background intensity control 

used to change bit ro vidro cards, however. 

varies with the different types CGA . s , nip lhe value 0 f 

,f you are using an MDA. a He^ ^P'"; j ue5 con , a i n ed in this 

one bi, In the CRT contno.ler, ^"1 ^ ^ , he 

register are stored mthe OOSK £ ^ |angyagc nip lhe control bit from 

“5 BNG^and *en called again to Hip back to BUNK: 

.CODE 


Flip 


PROC USES ES 

MOV AX,'C04«h 

MOV ES.AX 


FLIP 


MOV 

ADO 

MOV 

XOR 

MOV 

OUT 

RET 

ENDP 


DX,ES:[0063h) 

DX,4 

AL,ES:l0065h] 
AL,20h 

ES:I0065hj ,AL 
OX, AL 


point it to BIOS RAM 
CRTC base port address 
offset to control port 
image of current content 
flip blink-enable bit 
put it back 
and send to CRTC too 
to caller 


If you are using an EGA. MCGA. or VGA, you must go through the vtdeoBfOS 
routines to switch this bit; refer to Chapter 20, “Accessing BIOS Services, 
and a code example. 

Table 17.10 lists the colors built Into the CGA; If you use an EGA, MCGA ^ 
VGA, you can modify the exact colors that correspond to each b,t “ ,un Jf . ^ 
EGA. you can select any l6of 64 different shades; these are composed from the ^ 
primary colors (red, blue, and green) and four levels of each color (none, ^ 
and 3/3 brightness). Thus, black is obtained by having all three colors o , 
white, by having all three at 3/3 brightness. The MCGA/VGA cards are sun 


&;? > • 
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1100 

12 

1101 

13 

1110 

14 

1111 

15 


Light red 
Light magenta 
Yellow 

White ( high intensity) 


How can you apply this information to enhance the routines developed in this 
chapter? You do not need to change the FindCard routine, which simply locates the 
type of card and sets two variables for use in the other routines. But PCHAR and 
PString can be changed so that they use a specified attribute value. 

PCHAR is’ written to display a character on either a monochrome or color 
monitor. If the original routine were modified so that it could make an intelligent 
decision about converting attribute values, the high-level program could be written 
to take advantage of a color monitor, but PCHAR would translate the character 
attribute to a display format appropriate for-a monochrome display. This new 
implementation, PCHARA (meaning print character with attribute ), is as follows: 

p «0« 69,132 
Consent • 


PCHARA.ASM 

Author: Allen L. Wyatt 

Date: 8 / 11/91 
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Purpose: 


To print a character on the video screen, setting the 
video attribute according to the color table values if 
using a monochrome display. 


Format: AL * ASCII value of character to print 

01 « video buffer offset at which to place AL 
Attribute should be initialized by calling routine 


« 


PUBLIC PCHARA 
PUBLIC Attribute 

EXTRN Monitor_Addr:WORD 
EXTRN Statu$_Port:WORD 

.MODEL medium,BASIC 


MONO 

EQU 

0B606h 

COLOR 

EQU 

OBoeeh 


.DATA 


Attribute 

OB 

N 

Attr_Test 

06 

66 

Color_Table 

EQU 

THIS BYTE 

BWT_BLK 

08 

6 Fh,6Fh 

BLU_BLK 

06 

61h,61h 

YEL_BLU 

OB 

lEh,76h 

BLU_WHT 

06 

71h,76h 

GRNJAMT 

OB 

72h,76h 

CYNJ0HT 

08 

73h,76h 

REDJfKHT 

06 

74h,76h 

MAOWHT 

DB 

75h,70h 

BRN_WWT 

06 

76h,76h 

QRYJKHT 

OB 

78h,76h 

LBL_WKT 

06 

79h,76h 

LGRJAfHT 

06 

7Ah,76h 

v-CY_k)HT 

OB 

7Bh,76h 

LRDJYWT 

06 

7Ch,76h 

LMGJ4HT 

08 

70h,76h 

YELJWHT 

D6 

7Eh,76h 

8WrT_WHT 

06 

7Fh,76h 

lr^LE_END 

08 

68h,07h 




;Mono video buffer start 
;Color video buffer start 


;Black background 


;End of table 
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. COOE 

PCHARA PROC USES BX DX SI ES ;Store registers used in this routine 

MOV ES,Monitor_Addr 

MOV DX,Status_Port 

; Handle translation for monochrome monitors 



MOV 

AH,Attribute 

;Get video attribute 


CMP 

Monitor_Addr,COLOR 

;Is it a color monitor? 


JE 

No_Trans 

;Yes, assume correct 


CMP 

AH,Attr_Test 

;Is it the same as before? 


JE 

No_Trans 

;Yes, so keep going 


MOV 

SI.OFFSET Color_Table 

Color_Loop: 

MOV 

BH.(SI) 

;Get the first color 


INC 

SI 

;Point to mono equivalent 


CMP 

BH.O 

;End ot table? 


JE 

Set_Color 

;Yes, so use default 


CUP 

AH.BH 

;Should we translate? 


JE 

Set_Color 

;Yes, so set new color 


INC 

JUP 

SI 

Color_Loop 

;Skip the mono equivalent 

Set_Color: 

MOV 

AH.ISIJ 

;Get mono equivalent 


MOV 

Attr_Test,AH 

;Reset the test byte 

No_Trans: 

CLI 


;Don’t allow interrupts 


PUSH 

AX 

;Store the character 

Retrace: 

IN 

AL.OX 

;Get card status 


TEST 

AL.1 

;Are we in a retrace state? 


JNZ 

Retrace 

;Yes, so check again 
;On fall-through, Just 
; exited retrace state 

No_Retrace 

: IN 

AL.OX 

;Get card status 


TEST 

AL, 1 

;Are we in a retrace state? 


JZ 

No_Retrace 

;No, so check again 
;On fall-through, just 
; entered retrace state 


POP 

AX 

;Yes, get character back 


MOV 

ES:|DI),AX 

;OK to write it now 


STI 

» 

;OK to have interrupts now 
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INC 

INC 


01 

01 


;Point to attribute 
;Next ecreen location 


RET 

PCHARA ENDP 

END 

* This new version of the routine Is only slightly different from the earlier PCHAR. 
The modified routine has the additional data areas needed for the attribute and the 
attribute translation. 

The translation table begins at the label COLOfl.TABLE. Each color attribute to be 
translated is listed, followed by the monochrome equivalent of the attribute. For 
instance, the color attribute for a yellow foreground on a blue background (YEL.BLU) 
translates to an inveVse (black-on-white) attribute in monochrome. 

A 0 in the color-attribute position signifies the end of the table. Any translation 
that has not been caught specifically In the table is translated to normal monochrome 
white-on-black. 

This translation process is handled in PCHARA by the coding beginning at the 

line 

; Handle translation for monochrome monitors 

First, PCHARA checks whether a monochrome monitor is in use. If not, no 
translation is needed, and processing continues. If a monochrome monitor is in 
use, the old attribute (Attr_Test) is checked against the new one. If the two attributes 
are the same, no translation is needed, and processing continues. 

If a translation is indicated, PCHARA loads the offset of Color_Table into SI. 
Next, the attribute byte at that location (SI) is loaded, and SI is incremented to point 
at the monochrome equivalent of the color attribute. Then PCHARA checks for the 
end-of-table flag. If the end has been reached, the routine is exited, the default 
attribute (white-on-black) is loaded, and the character is displayed. If a valid 
translation is needed, the new attribute is loaded from the table and the character 
is displayed. 

Notice that in this version of PCHARA an entire word (both the ASCII value 
and its attribute) is moved into the video buffer, in the earlier version of the routine, 
only the ASCII character was moved to memory. 

The overhead associated with the changes to this routine is a small price to p*V 
for the added value received. Now you can control not only which character 
displayed but also how a character is displayed. 

Notice that Attribute is assumed to have been set before entry into PCHARA 
Attribute is a video attribute that can be set in PString with a value passed from a 
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high-level language. You can set Attribute* 
PStringa, which is written for compiled BASIC: 


using the 


following new version. 


Page 69,132 
Content ’ 


File: PSTRINGA.ASM " *' 

Author: Allen L. Wyatt ’ 

Date: 9 / 11/91 ! 

• * 1 •« ' 

Purpose: TO display a strlrg directly to video memory from 
compiled BASIC, including the video attribute. 

Format: CALL PStringa(A$,XH,Y%,z\) 

A$. The BASIC string to be displayed. 

X\: The integer column value. 

YV The integer row value. 

Z\: The integer video attribute. 


I 


PUBLIC 

PStringa 

EXTRN 

FindCard:FAR 

EXTRN 

PCHARA:FAR 

EXTRN 

’ « 

Attribute:BYTE 

.MODEL 

medium, BASIC 

.CODE 



PStringa PROC String, Column, Row, Video_Attr:WORD 


CALL 

FindCard 

.•Locate the video buffer 

MOV 

BX,Video_Attr 

;Address of attribute value 

MOV 

AX.IBXJ ~ 

;Get attribute value ‘ 

MOV 

Attribute,AL 

;Only working with a byte 

MOV 

BX,String 

;6*t BASIC's string pointer 

.MOV • 

CX.IBXJ 

.Get the string's length 

JCXZ 

Exit 

;No length, so don't print 

MOV 

SI,(BX+2) 

;SI points to string 
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MOV 

BX,Row 

;Get address for row 

MOV 

AX.IBXJ 

;0et row value 

DEC 

AX 

;Put as a zero offeet 

MOV 

BX,Column 

;Q«t addreoa for column 

MOV 

DI.IBX1 

;Get column value 

DEC 

DI 

;Put AS zero offeet 

MOV 

BX.80 

;80 characters/row 

MUL 

BX 

;Now have rows In AX 

ADD 

Dl.AX 

;Add to column number 

SHL 

01,1 

;Multiply by 2, DI**offaet 

PSLOOP: MOV 

AL,[SI1 

;Get the string character 

INC 

SI 

;Point to the next character 

CALL 

PCHARA 

;Print the character 

LOOP 

PSLOOP 

;Redo for length of string 

Exit: RET 



PStrings ENDP 



END • 



There Is only one difference between this and the earlier version of PString. 


Withtthis version you can pass an additional variable by BASIC to specify the attribute 
of the string being printed. This attribute is placed in the variable Attribute for 
subsequent use by PCHARA. 

Notice that even though a word (16-bit integer) is passed from BASIC, only the 
lower byte of the word is used for the attribute. As you may recall from the memory- 
mapped display of the IBM computer family, only one byte is used to specify a 
character’s attribute. 

Creating Text-Based 
Graphics Routines 

Now that you know how information is stored on the screen and how the 

appearance of the information is controlled, you can use these building blocks to 

create routines for handling text-based graphics. Such routines are helpful whenyou 

create attractive menus or data-input screens. Using assembly language, you can 

paint apo aling screens and display them instantaneously to enhance the image of 

y ^ Uf ac ^ ition » >' ou can create the screens and menus with one call from 

your high-level language. 
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charanc^ai^wcu'su^d^orASClI^^'D'hi'cs^Th^ °‘ |" icrocom P u,crs ' **««• 

ii r graphics. These characters were designed 

deferent wouos^f ASrn CrCCn h f0rmS and dispUy oudines Figure 17.2 shows the 
different groups of ASCII graphics characters. 



Let's create a routine that uses some of these ASCII graphics characters to 
display a double-Uned box anywhere on the screen. Ail you have to do is pass the 
coordinates for the upper left and lower right comers of the box, along with the 
cUplay attribute to use when creating the box. This routine, appropriately named 
®°*» U coded as follows when called from compiled BASIC: 
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.^C )(}■ PaftUl: APP^ng Langu^Tcdimques_ 


j'Paoe 60,r32 '‘ 

'Comment f. 




File: BOX. ASM.. .... 

Allen L. Wyatt 
9/13/91 

To display a double -lined box from QuickBASIC 

CALL Box(TLC*,BflC%|Z%) 

TLC%: The top left screen coordinate. 

BRC%: The bottom right screen coordinate... . 
ZH: T’.ie integer video attribute. 


PUBLIC, Box 



EXTRM. 

FindCard:FAR 



EXTRN 

'Jet_DI:FAR 



EXTRM 

PCHARA:FAR 



EXTRM 

Attribute: BYTE 



.MOOEL 

medium, BASIC 

w 


.DATA 


' « 

BoxChar 

DB 

=t1 . ILjJI IK 


BOXULC 

EQU 

THIS WORD 


ULXQl 

DB • 

09 

# 

UL Row 

DB 

09 


BoxLRC 

EQU :: 

THIS WORl 

i 

Lff^Col 

DB 

09 


LR_Row 

DB 

09 

- • 

• 

.CODE 

# 

• 

Box 

PROC TLC, BRC, Video_Attr:WORD 


MOV 

BX,Video_Attr 

;Get address of attribute 


MOV 

AX,(BX1 

;Get value of attribute 


MOV 

Attribute,AL 

;Store the attribute 


MOV 

BX,BRC 

;Get address of BRC 


Author: 

Date: 

Purpose: 

Format: 
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MOV 

ax.ibxj 

MCM< . 

BoxLRC.AXi 

MOV 

MX,TLC 

MOV 

;AX,(BX1 

MOV 

BoxULCVAX 

CALL 

FindCard 


; Print sides of box, top to bottom 


;Get value of BRC 
;Store the value 
;Get address of TLC 
;Get value of .,TLC 
;Store the vaiue 

{Locate the;monitor, ipfo 


VI: 


; Print 


TBl 


MOV 

BH,UL_Row 

INC 

BH 

MOV 

AL,BoxChar+4 

MOV 

:CH,UU^Row . 

MOV 

CL,LR_Row 

SUB 

cl 4 ch 

SUB 

CH;CH ii 

DEC 

. -CX-.u .. 

MOVw 

BL^UL^Col 

CALL 

SetJJI* 

CALL 

PCHARA 

MOV 

BL.LR^COL 

CALL 

*tt L DI 

CALL 

1 PCHARA. 

INC 

BH 

LOOP 

VI 


top of box 

MOyjomaBX.PoxULC . 
INC BX 

CALL Set_DI 

MOV AL,BoxChar+5 

MOV CL,LR_Col 

MOV CH,UL_Col 

SUB CL,CH 

SUB . CH.CH 
OEC •.* 

;ch; 

CALL PWOWA 

LOOP TBl 


;Get upper left (row only) 
{Start next row down,,:, 
{Character for side of box 
{Top ror 
{Bottom row 
{Height left in CL 
{Zero out CH • 

{Adjust for actual hsigbt 
{Set left column 
{Pcsltlon offset 

{Set right column 
{Position offset 

{Next row 


{Get upper left column 
{Next space right 
{Position offset 
;Top/bottom character!, 
{Left column 
{Right column 

;Zero out 

{Wlatn of boi' is in Ck 
:»'tb.‘e widfh for latiei* 

;l/d U again 


; Print bottom of box 
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MOV 

MOV 

bh,lr_ro* 

BL ,UL_Col 

;Now have bottom left i 

INC 

BX 

;Next space right 

CALL 

8et_DI 

;Position offset 

POP 

CX 

;Grt width back 

MOV 

AL,BoxChar*6 

;Top/bottom character 

TB2: CALL 

PCHAAA 


LOOP 

TB2 

;Oo it again 

; Print corners 



MOV 

BX,BoxllLC 

;Upper left 

CALL 

8et_DI 

{Position offset 

MOV 

AL,BoxChar+2 

{Upper left character 

CALL 

PCHAAA 

• 


MOV 

BX'BOxLhw 

{Upper right 

CALL 

8et_DI 

{Position offset 

MOV 

AL.BoxCharO • 

{Lower right character 

CALL 

PCHAAA 


MOV 

BH,UL_Aow 


MOV 

BL,LB_C0l 

{Upper right 

CALL 

8«t_DI 

{Position offset 

MOV 

AL.BoxChar 

{Upper right character 

CALL 

PCHAAA 


MOV 

BH,LA_Pow 

- 

MOV 

BL,UL_Col 

{Lower left 

CALL 

8et_DI 

{Poaltion offeet 

MOV 

AL.BoxChar*1 

{Lower left character 

CALL 

PCHAAA 


BET 



Box ENOP 



ENO 




This routine displays a double-lined box at the specified location on the video 
screen without erasing the area inside the box. Using the following equation, the 
controlling program—In QuickBASIC—passes the coordinates through an integer 
variable that contains the row/column coordinates: 

COORD* - ROW • 236 + COLUMN 
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Because the controlline nmoro™ 

manipulated less during the execution oMhl i * ' q , ua " on ' " um *>«rs need to be 

coordinate, are passed In a fonnat*TpU c ' LT? ^ equatto ". ' h ' 

ger parameter, and the column In the lower bne " “ Pper by,C of ' hc 
This routine is deslonrH 

for the box. To draw a different tynT^f ST ***** thc of border used 

BOX.CHAB to the six appropriate di^ig t^. y ° U dUn8e thc «*'««» of 

as another subroutine, S^di*™ e r &M , ni i used ln ***** routln e. as weU 

coordinate, which is held ln~BX into af s « br oudne converts a row/column 
Set.DI follows: ’ lnt ° *" ofisct in ‘° the*video buffer The code for 


Page 60,132 

Comment J 

File: 

Author: 

Date: 

Purpote: 

setdi.asm 

Allen L. Wyatt 

9/13/91 

To set DI from BX. On entry, 
screen row/column, on exit, 
offset. All other registers 

BX contains the desired 

DI contains the screen memory 
are unchanged. 


PUBLIC Set_DI 

1 


.MODEL medium, BASIC 


e 

1 . 

.CODE 


Set_DI 

PROC USES AX BX DX 



MOV AH.B 

;Don’t need AM now 


MOV AL.BH 

;Move the row 


MOV BH, • 

;And zero it out 


MOV 01, BX 

;Move the column 


MOV BX,80 

,columns per row 


MUL BX 

;AX » row • 80 


ADD 01,AX 

;Add to column 


SHL 01,1 

;Multiply by 2 
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RCT 

S*t 01 tNOP 


END 


By ..uJylng BOX. you cin .<* how eirfly you « P>«€- fen.pl.fc3 on thd video 
. ' n iislna ASCII chaiac.cn, you c«n change ihe rpullnc lo Create any rype ot 
~ JSS£«. W..U The »(*cd wl.h wh.ch awcmbly tanguage. pU*«b. 

screens uuy surprise you. 


Using Window Techniques. 

Saving and Restoring Windows 

Now that you know how to create boxes, you can take next logical step- 
creating routines that can generate pop-up windows from compiled BASIC. 

To create pop-up windows, you need to follow these steps; 

1. Determine the rectangular coordinates of the area to contain the window. 

2. Save the current screen contents In that area. 

3- Clear the defined area. 

4. Draw a box around the area. 

Perhaps the most Important step Is that of saving the video information under 
the pop-up window, Step 2. A complete routine must not only save litis iriorm* 
atlon but also be able to restore previous video Information. Recreating the entire 
screen after the user is finished with the window is unacceptable and, in many cases, 
impossible. 

The routines described In this section will perform all these tasks. With tliepc 
routines you can use a “window stack” to save and create multiple windows iU?Jog 
this stack concept, you can remove the windows front the screen In reverse order. 

The following listing Includes t;wo callable routines. SXVSCRN. which is similar 
to the process used In DQX, require? the passing of the upper left comer and lower 
right comer of the window area; GETSCRN removes the previously created window. 
The listing Is as follows: 
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Page 60,132 
Comment l 


File: SCRN.ASM 

Author: Allen L. Wyatt 


Date: 9/13/91 

Purpose: To save and restore a portion of the screen to a buffer 
from QuickBASIC. 

Format: CALL SaveScrn(TLC%,BRC\,BH,C%) 

TLCV. The top left screen coordinate 
BRCV. The bottom right screen coordinate 

BV. The integer video attribute to use for the box outline 

C%; me integer video attribute to use for inside the box 


CALL 

GetScrn 



PUBLIC 

SaveScrn 


PUBLIC 

GetScrn 


EXTRN 

Set_DI:FAR 


EXTRN 

PCHARA:FAR 


EXTRN 

Monitor_Addr:WORO 


EXTRN 

Status_Port:WORD 


EXTRN 

Attribute:BYTE 


.UOOEL 

.DATA 

medium, BASIC 

Temp 

DW 

eeee 

WindowJNidth 

OW 

eeee 

BoxChar 

DB 


BoxULC 

EOU 

THIS WORD 

UL_Col 

DB 

M 

UL_Row 

DB 

•t 

BoxLRC 

EGO 

THIS WORD 

LR_Col 

DB 

00 

LRROW 

DB 

00 
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Screens 

EndScreens 


SaveScrn 


SS CONI: 


SS_LOOP: 


SS_L2: 


DB 4 DUP(1024 DUP(O)) ;Screen stack space 

D6 eo ;End of screen stack space 


.CODE 

pnoc TLC, BRC, Box_Attr, Field_Attr:WORD 


MOV 

BX,Box_Attr 

MOV 

AX,|BX) 

MOV 

Attribute,AL 

MOV 

BX ,BRC 

MOV 

AX,(BXJ 

MOV 

BoxLRC.AX 

MOV 

BX.TLC 

MOV 

AX,|BX J 

MOV 

BoxULC.AX 

CALL 

CalcSize 

CALL 

FindFree 

JNC 

SS_CONT 

JMP 

SS_EXIT 

PUSH 

SI 

ADO 

SI,6 

MOV 

AX.BoxULC 

MOV 

Temp,AX 

MOV 

BX.Temp 

CALL 

Set_OI 

MOV 

ES,Monitor_Addr 

MOV 

CX,Window_Width 

MOV 

AX,ES:(DI) 

MOV 

1 SI|,AX 

INC 

DI 

INC 

DI 

INC 

SI 

INC 

SI 

LOOP 

SS_L2 

ADD 

Temp,0i00h 

MOV 

AX,Temp 

MOV 

BX.BoxLRC 

CMP 

AH.BH 

JLE 

SS LOOP 


;Oet address of attribute 
;Get value of attribute 
[Store tne attribute 
;Get address of BRC 
;Get BRC value 
[Save it 

;Get address of TLC 
;Get TLC value 
;Save it 

;Calculate space for save 
;Find free space in screen 
; stack area 
[Continue 

[Sorry, no space left 
[Save area 

[Set past pointer area 
[Move upper left corner 
; into work area 

[Set offset 

[Get character/attribute 
[Place into screen stack 
[Point to next display set 

[Increment stack pointer 

[Do for entire line 
[Proceed to next line 


[Are we too far down? 
[No, so continue 
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MOV 

BX.SI 

POP 

SI 

MOV 

AX.BoxULC 

MOV 

ISIl.AX 

INC 

SI 

INC 

SI 

MOV 

AX.BoxLRC 

MOV 

ISIJ.AX 

INC 

SI 

INC 

SI 

MOV 

ISIl.BX 


Get end of sc een in stack 
Get start of area 
;Store upper left corner 
1 coordinates 
Point to next coordinate 
location 

Store lower right corner 
coordinates 

Point to next coordinate 
location 

Store pointer to start of 
stack free space 


; Print sides of box, top to bottom 

MOV BH,UL_Row 

INC BH 

MOV AL,BoxChar+4 

MOV CH,UL_Row 

MOV CL,LR_Row 

SUB CL,CH 

SUB CH.CH 

DEC CX 

Vi: MOV BL,UL_Col 

CALL Set_DI 
CALL PCHARA 

MOV BL,LR_Col 

CALL Set_DI 

CALL PCHARA 

INC BH 

LOOP VI 

; Print top of box 


MOV 

BX.BoxULC 

INC 

BX 

CALL 

Set_DI 

MOV 

AL,BoxChar+5 

MOV 

CL,LR_Col 

MOV 

CH.UL_.Col 

SUB 

CL.CH 

SUB 

CH.CH 

DEC 

CX 

PUSH 

CX 


;Get upper left (row only) 

;Start next row down 
-.Character for side of box 
;Top row 
;Bottom row 
•.Height is left in CL 
{Zero out CH 

-.Adjust for actual height 
;Set left column 
;Position offset 

;Set right column 
;Position offset 

;Next row 


;Get upper left column 
;Next space right 
{Position offset 
;Top/bottom character 
;Left column 
{Right column 

{Zero out 

{Width of box is in CX 
{Store width for later 
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TBl: 


CALL 

LOOP 


PCHARA 

TBl 


;Do it again 


Print bottom of box 


TB2: 


Print corners 


MOV 

BH,LR_Row 


MOV 

BL,UL_Col 

;Now have bottom left corner 

INC 

BX 

;Next apace right 

CALL 

BetJH 

;Position offset 

POP 

CX 

;Oet width back 

MtfV 

AL,BoxChar*5 

;Top/bottom character 

CALL 

PCHARA 


LOOP 

TB2 . 

;Do it again 

MOV 

BX.BoxULC 

{Upper left 

CALL 

Sot.DX 

{Position offset 

MOV 

AL,BoxChar*2 

{Upper left character 

CALL 

PCHARA 


MOV 

BX,BoxLRC 

{Upper right 

CALL 

Set_DI 

{Position offset 

MOV 

AL,BoxChar+3 

{Lower right character 

CALL 

PCHARA 


MOV 

BH,UL_Row 


MOV 

BL,LR_Col 

{Upper right 

CALL 

SetJJl 

{Position offset 

MOV 

AL.BoxChar 

{Upper right character 

CALL 

PCHARA 


MOV 

BH,LR_R0W 


MOV 

BL,UL_Col 

{Lower left 

CALL 

Set_DI 

{Position offset 

MOV 

AL,BoxChar*1 

{Lower left character 

CALL 

PCHARA 


MOV 

CX,BoxULC 

{Upper left corner 

ADO 

CX,B1B1h 

{Don't erase box 

MOV 

DX.BoxLRC 

{Bottom right comer 

SUB 

DX.BIBlh 

{Don't ersse box 

MOV 

BX.Fitld.Attr 

;Qet address of attribute 

MOV 

ax.ibxi 

;Oet value of attribute 
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SS_EXIT: 

SaveSern 

• 

1 .. - 

uov 

uov 

uov 

I NT 

CLC 

RET 

EMDP 

bh.al 

AH,6 

al.o 

1th 

;Store the attribute 
;Clear upwards 
;Clear the window 
;Call BIOS interrupt 

;No errors 

GetSern 

PROC 




CALL 

FindLast 

;Find last saved screen 


JC 

GS_EXIT 

;Sorry, none there 


PUSH 

SI 



UOV 

AX,(SI) 

;Get upper left corner 


uov 

BoxULC,AX 

;Store in this area 


UOV 

Teup.AX 

;Store in work area 


INC 

SI 

;Point to next coordinate 


INC 

SI 

; location 


UOV 

AX,[SI) 

;Get lower right corner 


UOV 

BoxLRC.AX 

; and store it 


INC 

SI 

;Point to next coordinate 


INC 

SI 

; location 


UOV 

AX,(SI) 

;Get pointer to next area 


PUSH 

AX 

;Save temporarily 


INC 

SI 

;Point to next coordinate 


INC 

61 

; location 


CALL 

CtlcSizt 

;Thia will set the width 

GSJjOOP: 

UOV 

BX.Teup 

/ 


CALL 

Set_DI 

;Position cursor there 


UOV 

CX, WindowJUfidth 


GS_L2: 

UOV 

AX,[SI) 

;Get from stack area 


CALL 

UoveChar 

;Uove the character 


INC 

81 

;Point to next character 


INC 

61 

; group 


LOOP 

0S_L2 

;Repeat for entire line 


ADO 

Taap.titth 

;Point to next line 


UOV 

AX.Ttup 
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l*.in 


HI Applying Assembly language 


MOV 

CMP 

JLE 


BX.BoxlRC 
AH ,BH 

GS LOOP 


; Are we too far down? 
;No, SO continue 


* 


POP 

BX 

POP 

SI 

SUB 

BX, SI 

INC 

BX 

MOV 

Ax.e 

MOV 

CX.BX 

MOV 

(SI],al 

INC 

SI 

LOOP 

FL 

CLC 


BET 


ENDP 



;Get back next area pointer 
;Get back start 
;Size of area 

;Zero out entire area 


;Set for no errors 


• Subroutines for SaveScrn and GetScrn 


FindFree 


Find a block on screen stack large enough to hold window 
Enter with CX set to sue needed, in bytes 


FindFree 

PROC 



LEA 

SI.Screens 

FFJ.OOP: 

MOV 

BX,|SI«4] 


CMP 

BX.O 



JE 

FoundFree 


MOV 

SI.BX 


JMP 

FFLOOP 

FoundFree: 

MOV 

AX,SI 


ADD 

AX,12 


ADD 

AX.CX 


LEA 

DX.EndScreens 


CMP 

AX,OX 


;Start of screen stack 
;Get pointer to next area 
;ls there anything here? 

; bx equal to 1 past end 
; of saved screen if so 
-.Nothing here 
;Point to next screen set 
I Keep looking 

;Set to beginning of entry 

;Add enough for two sets of 

; pointers 

;Add length of save 

;End of screen stack 

-.Are we past end of stack? 


Scanned by CamScanner 








(.luiptcr I"* Video Memory 
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JQE 

FF_N0PE 

;Yes, too bio (can't save) 


CLC 


;Return without error 


JNC 

FF_EXIT 


FF_N0PE: 

STC 



FF_EXIT: 

RET 


{Return to caller 

FindFree 

ENDP 




• . 

; CalcSize 

• 

1 

• Calculate the space needed for 
Returns with CX set to number 

the window area 

of bytes 

• 

CalcSize 

PROC 




MOV 

AX.BoxULC 

;Get upper left corner 


MOV 

BX.BoxLRC 

;Lower riQht corner 


SUB 

BX,AX 

;Absolute rows/columns 


ADO 

BX,O101h 

;Set to actual numbers 


MOV 

ax,o 



MOV 

AL.BH 

;Number of rows in AX 


MOV 

BH ,0 

;Number of columns in BX 


MOV 

Window_Width,BX 

;Save width for later use 


MUL 

BX 

;Character positions in AX 


SHL 

AX, 1 

{Number of bytes in block 


MOV 

CX.AX 

;Put in proper register 


RET 


;Return to caller 

CalcSize 

ENOP 




• 

; FlndLast 

• Locates 

the last saved 

screen on the screen stack 

1 

FlndLast 

PROC 


* 


LEA 

SI.Screens 



MOV 

AX ,0 



PUSH 

AX 

;Save original pointer 

FLJ.OOP: 

MOV 

BX,(SI*4) 

;Get pointer to next area 


CMP 

BX.t 

;Is there anything here? 




; BX equal to 1 past end 




; of saved screen if so 


JE 

FoundLast 

{Nothing here, at end 


POP 

AX 

;Get back old pointer 


PUSH 

SI 

{Save where we are now 


MOV 

SI.BX 

{Point to next screen set 


JMP 

FL_LOOP 

{Keep looking 
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FoundLast: 

POP 

CMP 

SI 

si,e 

;Get back the good pointer 
;Was it zero (nothing to 
; restore)7 


JE 

FL.NOPE 

;Yes, so error 


CLC 


;Return without error 


JNC 

Fl_EXIT 


FL_NOPE: 

STC 



Fl_EXIT: 

RET 



FindLast 

ENDP 



1 

; MoveChar • 

Move a character into the 

video buffer (similar to PCHAR) 

1 

MoveChar 

PROC 

USES OX ES 


• 

MOV 

ES,Monitor_Addr 


MOV 

DX,Status_Port 



CLI 


;Don't allow interrupts 


PUSH 

AX 

;Store the character 

Retrace: 

IN 

TEST 

AL.DX 

AL, 1 

;Get card status 

;Are we in a retrace state? 


JNZ 

Retrace 

;Yes, so check again 
;0n fall through, Just 
; exited retrace etate 

NoRetrace: 

IN 

TEST 

AL.DX 

AL, 1 

;Get card status 

in a retrace etate? 


JZ 

NoRetrace 

;No, so check again 
;0n fall-through, Just 
; entered retrace state 


POP 

AX 

;Yes, get character back 


MOV 

ES:(01),AX 

• ;0K to write it now 


STI 


;0K to have interrupts now 


INC 

01 

;Point to attribute 

• 

INC 

01 

;Next screen location 


RET 



MoveChar 

ENOP 



I 

ENO 
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Uuplcf I n \ulc'ii Memory 


I hK sc of routines is an example of ,!„• p„ m , ma.le a, the brg„„„„g „l tins 
KH»k-.ha, sour, erode lo, assembly language roultnes takes a great .leal ol spa.e 
ttben assembled bossever. the resulting object code is significant!, smaller than 
similar routines written entirely in BASIC. 

Notice that these routines, particularly SaveScrn. do not use the SI and hi 
registers in the usual manner, in these routines. Dl points to the source, whereas si 
points to the destination I did this so that maximum use could he made of existing 

routines such as Set_DI. I hope that the purists among you will not become 
incensed 


As much as 4 K of screen data (the s uc of the entire screen) can he saved by using 
SaveScrn Because most pop up windows do not use the whole screen, you can save 
several windows If you find that you need a larger screen-stack area, you can 
increase the area by changing the number of bytes defined by Screens. 

Notice that GetScrn uses a subroutine called MoveChar You will find, on 
examination, that MoveChar seems similar to pchar, the routine developed earlier in 
this chapter Right you are' The routines are similar because they do almost the same 
thing they store rnformation into the video buffer A new routine was warranted 
because, instead of using the default Attribute (as pchara does), you are retrieving 
data one word at a time. 

If you want to collect these routines into a library for use with QuickBASIC’s 
command-line compiler capability, you can use the makefile VIDtO shown in 

Chapter 8 to do so. The follow ing QuickBASIC program demonstrates most of the 
library’s functions: 


t m 

g 1 

• • 

File: 

VIDTEST.BAS 

• • 

Author: 

Allen L. Wyatt 

• • 

• • 

Oate: 

9/14/91 

• • 

Purpose: 

Sample program to demonstrate use of video 

• 

• 

• 

• » 


subroutines. Designed to run under compiled 
BASIC. 


DEFINT A 2 


CIS 
r • 4 

C ■ 1 

FOR a « 1 TO 255 


I 


409 
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a $ * RIGHTSC ‘♦STR$(a)*‘ *,5) 
r ■ r ♦ 1 
IF r > 24 THEN 
r ■ 5 

c - c ♦ LEN(a$) ♦ 1 
ENOIF 

CALL PStrinfla(a$, c, r, a) 

NEXT a 

LOCATE 1,1 

PRINT ‘First test completed, screen painted with PStringa* 
PRINT ‘Second test ready to start: screen saving* 

LINE INPUT ‘Press ENTER to begin*;a$ 
tic * 5 * 256 ♦ 5 
brc * 20 * 256 ♦ 75 
ba = 30 
fa * 30 

CALL SaveScrn(tlc, brc, h,a, fa) 

LOCATE 1,1 

PRINT ‘Second test completed, screen saved with SaveScrn 

PRINT ‘Third test ready to start: box drawing 

LINE INPUT ‘Press ENTER to begin*;aS 

tic - 10 * 256 ♦ 20 

brc * 15 * 256 ♦ 60 

a « 50 

CALL Box(tlc, brc, a) 

LOCATE 1,1 

PRINT ‘Third test completed, box drawn with Box 
PRINT ‘Fourth test ready to start: screen restoring* 

LINE INPUT ‘Press ENTER to begin*;a$ 

CALL GetScrn 

LOCATE 1,1 

PRINT ‘Fourth test completed, ecreen restored with GetScrn* 
PRINT ‘All tests completed 
PRINT • 
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Chapter 17: Video Memory 411 


Summary 

The wide range of display adapters and monitors available for the IBM family 
^^jjnKTocomputers can all be classified in one of two categories—monochrome or 
color. Because the classiiu.*uon of display devices can be determined by software, 
you can write routines that quickly display video data on cuhe* category of display 
adapter. 

Video-display routines written in assembly language execute faster and take 
less object code space than those written in high-level languages. Adding assembly 
language display subroutines to a high-level language program increases the overall 
speed of the program, especially one that is heavily screen-dependent. 

The routines in this chapter were all written for compiled BASIC but cculd have 
been written just as easily for any other high-level language If you change the 
parameter-passing coding, the routines should work with C and Pascal as well as with 
compiled BASIC. 
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Accessing Hardware 

Ports 


Tf .?^ 0mmUn,CatC With P er 'Pheral devices, your I C’s CPU uses hardware ports 
X hese ports are areas that the 8086/8088 (or any descendant CPUs) accesses hv 
using special assembly language instructions. This chapter discusses specific hard^ 
ware ports and >he assembly language Ins.rucuons .ha. apply ,o .hemTn addmon 
he chapter covers several significant hardware-pon addresses, addresses imponani 

because they are used for direct control of such computer devices as the keyboard 
the video monitor, and the speaker. *cyooaru, 


- ThC 8086/8088 ch 'P fami, y can address as many as 65,536 hardware pons 
use of the way the IBM PC microcomputers were implemented, however the 

oThZr~ on,y thc f,m iK of ,/o addresses (hardwarc ,/o port addrcMes 


As the designs progressed through the XT, the IBM Personal Computer AT 
and thc PS/2 models, the same group of pon addresses was retained although some 
usage details changed. 


These addresses (memory locations) are accessible to both the microprocessor 
and thc I/O device. Before examining how the I/O pons are used, let s look at the 

specific manner in which the pons are accessed. 


413 
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Pan III Applying Assembly Lmguagc lechniqucs 


The IN and OUT Assembly 
Language Instructions 


The in and OUT assembly language instructions handle the transfer of data to 
and from hardware ports. By using these mnemonics, you can transfer a single byte 
of information to or from a port address. 

Because the I/O ports greally resemble specialized memory locations, you may 
wonder why you cannot use the MOV instruction to transfer the appropriate 
mformatioiv There is a good reason: the architecture of the Intel CPUtaw-doe.. 
not mix these two kinds of addresscs-RAM and I/O port memory are kept separate^ 
The IN and OUT instructions cause different pins of the microprocessor to be activated 
for the data transfer. Therefore, when the 8086/8088 microprocessor executes 
instructions, it "knows” to access the specialized I/O hardware. 

If the peripheral device were designed to interface through main RAM. the IN 
and OUT instructions would not be needed. (Several ether manufacturer produce 
popular microprocessor chips, not used in the IBM line or its clones, that do in fact 
use such a "memory-mapped" approach to dealing with hardware ports; nyounv 
in Chapter 17, “Video Memory,” even the IBM designs mix the approaches 
dealing with video displays.) 

How then do you access these individual I/O pons? If the address of the port 
you are accessing is less than 256, you can code the address explicitly into the 
instruction, as in the following cxamp.e: 


IN 


AL(5C i ;Get a byte from the port 

Notice that the byte is read from the port address specified by the source 
operand (50) and placed in the destination operand, or AL register. All IN and OUT 
instructions assume that the data transfer will be between the port address and the 
AL register. Attempting to transfer data to a different register results in an error 
during the assembly process because the CPU cannot perform such a transfer to or 

from any other register. 


Because the IBM can access directly more than 256 I/O addresses, there must 
be a way to access these other ports. That method is to use the DX register to specify 
the port address. For example, the following code facilitates writing a byte to a port 

with a higher address: 


Retrace: 


MOV 

DX.CS:Status_Port 


CLI 


;Don't allow interrupts 

PUSH 

AX 

;Store the character 

IN 

AL.DX 

;Get card status 
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Y ™ 7 y "T“ ,h,s “* » » "“‘ton from Ihe listings in chapter 17 The 

' 1,0 PJT a ? d 7 55 ' Wh 'f h ““ d '° bt ' larscr 2"- •« loaded into DX and then 

used „r. the Retrace hne) to fetch a byte from that port and place the byte into the 


OUT works the same way as IN except that the data flows in the other direction- 
"* mU ? C operand < AL > lhe destination operand (the 
h^n 256 can be c^T T'f T ' he fo,lowin 8 e “ m P'«- port addresses lower 
!n“e DX regl^er ' XP ‘ ' ha ‘ “ h * hcr tha " 255 ««■ be specified 


OUT 50,AL 

OUT DX.AL 


info J^nn a rh ° UT Sla !f!? entS are ana, °8° us to *e MOV statement; they all transfer 
information. The main deference is that the MOV statement works on *VM memory 

whereas the IN and OUT statements work with I/O addresses. 

IN and OUT attempt to transfer information, regardless of the meaning of the 
port address supplied. Even if no device is using the port address, IN places a byte 
of information in AL, and OUT writes a byte of information from AL. The statements 
do not check whether a device is at the port address or whether the specified 
information was written successfully to a device. Because a peripheral device 
ordinarily uses more than one port address (perhaps one for input, one for output 
one for status, and one for line control), you can check different ports to verify the 
success of any mterfacing. (A tip: because the IBM PC data bu spulls up to binary 1 
uhen no hardware is enabled, an attempt to IN data • om an address that has no 
device connected usually returns a value of OFFh.) 


1 here is no standard among devices to stipulate how the interfacing will occur 
For instance, the procedure for communicating with the monochrome display 
adapter is different from the procedure for communicating with the asynchronous 
communications adapter. Each adapter or device uses different combinations of 
ports and addresses for different purposes. 


When transferring data to or from a port, remember that not all external port 
devices can respond fast enough to keep pace with modern processor chips this 
problem will continue to grow as processor speeds increase and port hardware 
becomes more complicated. To safeguard against problems caused by slow port 
devices, always follow any i n or OUT instruction with a do-nothing jmp $+2 statement. 

For a modern high-speed processor such as the 80286 or 80386, the effect of 
such a statement is much greater than you might think. Because RAM access is usually 
the limiting factor for CPU speed, these chips use a lookahead queue, built into the 
chip usclf. which contains the next several bytes of program code. The chips “cheat” 
by reading more th;n one byte per memory access. This lets the CPU decode the next 
instruction at *ne same time that it is executing the present one and possibly fetching 
the second, third, or tour.h into the queue. 
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Pan III: Applying Assembly language Techniques 


Clearly, execution of any jmp instruction makes all the (lata in the queue 
meaningless; because the next instruction has to come from somewhere else, the 
CPU flushes out and ignores everything in the lookahead area. It does so even if 
“somewhere else" is the exact same memory location from which the queue was 
loaded, as it is for jmp $+2. Thus, in addition to the time it takes m perform the JMP 
itself, this instruction slows down the CPU by the time required to reload the queue. 

Buying a high-speed CPU and then deliberately slowing it d< >wn by such r.«i mg 
tricks may seem wasteful. Keep in mind, however, that you need m .1. ■ tins only for 
the relatively few statements that move data to or from a hardware port. And if you 
are certain that the port can respond rapidly enough (a*- .vas the case with the vide u 
routines in Chapter 17) you need not do it at all Vs a general rule, however, u s the 
best policy to follow. 


The I/O Port Map 

IBM has defined some of the I U port addresses for specific I/O purposes. The 
first 256 I/O ports (O-FFh) are reserved for use by the system board. Peripheral 
devices that control such areas as memory refresh, timers, interrupt controllers, and 
coprocessor utilization are linked to the main system at these ports. 

The remaining I'O ports (I00h-3FFh) are used for other general-purpose I/O, 
with some areas set aside for specialized usage. Table 18.1 details the currendy 
defined hardware I/O addresses. 


Table 18.1 . Hardware I/O port addresses and tbeir usage. 

I/O Port Range 

Use/Purpose 

O-OFh 

8237—A direct memory-access (DMA) controller 

lOh 

Manufacturing test point (lOh-lFh arc additional 

DMA controllers in PS/2) 

20h-23h 

8259 Interrupt controller (controller 1 in AT and 

PS/2) 

30h-3Fh 

8259 interrupt controller 1 in AT 

40h-43h 

8253 timer (AT uses 8254, PS/2 uses 40h, 42h-44h, 
and 47h) 

50h-5Fh 

8253 timer (AT uses 8254) 

60h-6Fh 

8255 programmable peripheral interface on PC and 

XT, 8042 keyboard interface on AT and PS/2 

70h-71h 

Real-time clock and NM1 mask on AT and PS/2 


Scanned by CamScanner 




Accessing Hardware Ports 

HO Port Range 

Use/Purpose 

80h-8Fh 

DMA page registers (all models) 

90h-97h 

DMA page registers (PC, XT, and AT) I/O channel 
(PS/2) 

AOh-AFh 

Nonmaskable interrupt registers (PC and XT); 8259 
interrupt controller 2 (AT and PS/2) 

BOh-BFh 

8259 Interrupt controller 2 (AT only) 

COh-DFh 

8237 DMA controller 2 (AT and PS/2) 

EOh-EFh 

Reserved for system use 

FOh-FFh 

Numeric coprocessor usage 

lOOh-lEFh 

AT I/O channel, PS/2 uses 100-107 for programmable 
option select registers 

lF0h-lF8h 

AT fixed disk interface 

200h-20Fh 

Game controller (PC, XT, and AT only) 

210h-217h 

Expansion unit (PC and XT only) 

220h-26Fh 

Reserved (available for I/O on AT) 

278h-27Fh 

LPT2: (PC, XT, and AT); LPT3: (PS/2) 

280h*2AFh 

Reserved (available for I/O on AT) 

2B0h-2DFh 

Alternate EGA (PC, XT, and AT only) 

2E0H-2E3H 

GPIB 0 (AT only) 

2E8h-2EFh 

COM4: 

2F0h-2F7h 

Reserved 

2F8h-2FFh 

COM2: 

300h-31Fh 

Prototype cards (PC, XT, and AT only) 

320h-32Fh 

XT fixed disk interface 

360h-377h 

AT network (low address) 

378h-37Fh 

LPT2: (not on video card; PC, XT, and AT) 

380h-38Ch 

SDLC/secondary bi-sync interface (PC, XT, and AT) 

390h-39Fh 

AT cluster adapter 

3A0h-3A9h 

Primary bi-sync interface (PC, XT, and AT) 

3BOh-3BBh 

Monochrome display or PS/2 video 

3BCh-3BFh 

LPT1: (on video card) 

3C0h-3CFh 

EGA display control or PS/2 video 

3DOh-3DFh 

Color/graphics display or PS/2 video 

3E8h-3EFh 

COM3: 

3F0h-3F7h 

Floppy disk controller 

3F8h-3FFh 

COM1: 
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Areas not shown as defined or in use in table 18.1 are available for other I/O 
devices. Some third-party interface devices may use other I/O addresses that are not 
shown. Port addresses below 256 (FFh) are reserved for exclusive use by the system 
board, however. 

Because there is no real standard for communicating with external devices, and 
because such interfacing varies according to the type of device, the use of most I/O 
ports is not well documented in the IBM literature. In some cases, specialized books 
or manuals from either Intel or the specific peripheral manufacturer may contain 
relevant information. In the next few sections. I give you a brief look at some spe¬ 
cific ports. 


Some Significant Hardware Ports 

Several hardware-port addresses are significant to assembly language pro¬ 
grammers—those for the ports most often accessed through assembly language 
programs. 

Some hardware ports are used predominantly by the internal workings of 
BIOS and DOS routines (see Chapters 20 and 21). Other ports are available for 
different interface devices. Although the exact way in which all these ports may 
interact with your program is beyond the scope of this book, a quick look at some 
of the hardware-port addresses may be helpful. 


The 8259 Interrupt Controller 

The computer uses the 8259 programmable interrupt controller to control 
interrupts. The interrupt controller handles as many as eight interrupts, according 
to their priority sequence, presenting them to the microprocessor in prioritized 

order. 

As you can see from table 18.1, the 8259 interrupt controller uses four port 
addresses (20h through 23h). Although IBM documentation indicates that these 
four port addresses are reserved for the8259, only the two lower ports (20h and 2 lh) 
arc documented as usable by programmers. The other two pons (22h and 23h) are 
used only when reprogramming the 8259 for special dedicated systems that operate 
in modes not compatible with normal IBM PC operation. 
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will react when presented with a system interrupt. Before issuing an IRE? P the 
programmer is responsible for informing the system that I, can prt^ ot^r 
Interrupts. To do so, a 20h is sen, to I/O address 20h In the foUt^ng^f” 

MOV AL,20h 

OUT 20h,AL 


jSignal other interrupts OK 


elth C r P ^hUH b ^l ln !f.^ P i*^ k rCgiSlCr for the 8259 s P eciflc interrupts can be 

Table ir 2 h ? i dl#abled ’ depcnding on ±c ^nings of the bits In this register. 
Table 18.2 lists the meaning of the bits at the port. 



1 


0 

1 


0 

1 


0 

1 


0 

1 


7 (parallel primer) interrupt enabled 
IRQ 7 (parallel printer) interrupt disabled 
IRQ 6 (floppy disk controller) interrupt enabled 
IRQ 6 (floppy disk controller) interrupt disabled 
IRQ 5 (XT fixed disk controller) interrupt enabled 
IRQ 5 (XT fixed disk controller) interrupt disabl ed 
IRQ 4 (COM1:) interrupt enabled 
IRQ 4 (COM1:) interrupt disabled 
IRQ 3 (COM2:) interrupt enabled 
IRQ 3 (COM2:) interrupt disabled 
IRQ 2 Reserved interrupt enabled 
IRQ 2 Reserved interrupt disabled 
IRQ 1 (keyboard) interrupt enabled 
IRQ 1 (keyboard) interrupt disabled 


IRQ 0 (system timer) interrupt enabled 
IRQ 0 (system timer) interrupt disabled 
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The 8253 Timer 

The IBM PC family of microcomputers uses an 8253 11 m e rch 1 pi o co 

certain^ystem funcrions. This chip, which operates - 
provides for three independent timer channels and six s~ para p 

The 8253 is interfaced through I/O port addresses 4°hthrough«h.Port«h 
is used for timer channel 0 I/O. pon 41h for timer channel • "• d P on 

timer channel 2 I/O. Port 43h is used for mode control (see tab • )• 

Table 18.3■ Meaning of8253 mode-control bits for I/O port 43b. 


Bits 

7654321C 

00 

01 

10 

00 

01 

10 

11 

000 

001 

010 

011 

100 

101 


Meaning 


Channel 0 
Channel 1 
Channel 2 

Latch present counter value 
Read 'write only MSB 
Read 'write only LSB 
Read/write LSB followed by MSB 
Operation mode 0 
Operation mode 1 
Operation mode 2 
Operation mode 3 
Operation mode 4 
Operation mode 5 
e Binary counter operation 

! BCD counter operation 


The 8253 s three timer channels are used for different purposes in 
computer. Each channel has an associated.divisor (one word long) that mdiea 
how often the channel generates an interrupt. This divisor may range 
65.536. A divisor of 0 is equivalent to 65,536. To derive the channe in 
frequency, you divide 1.193.180 (the chip operating frequency) by the divisor. 
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Channel 0, which is used for the system timer, uses a divisor of 0 The resuh 

ing interrupt (INT 8, IRQO) frequency of 1,193.180/65,536 is approximately 18 2065 

'T'mntllKV 6, ° r ° nCC TV* 54 9 mUUseconds This channel is used to update 
the BIOS dock counter and the controls that turn off the floppy disk drive motor. 

This channe operates in mode 3, which signifies that the timer generates a square 
wave. 1 


Channel 1 is.uscd for DMA memoiy-refresh operations. It uses a divisor of 18 
rcsulungm a frequency of 1,193,180/18, or approximately 66,287.7778 times per 
8econ ? c ™! 15 to a DMA interrupt being generated approximately once 

every 15.086 microseconds. Operation of this channel is in mode 2, which signifies 
that a pulse is generated once every period. 

Channel 2, which is available for general use, is used most often with the 

speaker port. A specific example of this type of use is covered in the following 
section. 


The 8255A Programmable Peripheral 
Interface (PPI) 

The 8255A programmable peripheral interface (PPI) is used to control the 
keyboard, the speaker, and the configuration switches. Four port addresses. 60h 
through 63h, (or more, depending on the computer) are associated with this device. 

Because the use of each of these port addresses varies by computer, be sure to 
check your computer's technical documentation if you plan to program the 
addresses directly. This section provides some general information and direction 
but should not be accepted as “the gospel truth.” 

I/O port 60h is used for keyboard input and (on some versions of the IBM) for 
reading the configuration switches from the system board. If port 60h is used for 
reading the configuration switches, bit 7 of I/O port 6lh should be set. If this bit 
is cleared, port 60h is used strictly for keyboard input. This port and port 6lh are 
used in the examples shown later in this section. 

I/O port 6lh is used for configuration information for various devices, most 
notably the keyboard. Table 18.4 lists die meaning of the bit settings for this port. 
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Keyboard enabled 
PC-Read configuration switches 
XT—Keyboard acknowledge 
Keyboard click off 
Keyboard click on 

Parity errors from expansion ports enabled 
Parity errors from expansion ports disabled 
RAM parity errors enabled (used for speed control on 
some Turbo clones) 

RAM parity errors disabled (used for speed control on 
some Turbo clones) 



PC—Cassette mptor on (used for speed control on 
some Turbo clones) 

PC—Cassette motor off (used for speed control on 
some Turbo clones) 

XT—Read high nibble, configuration switches, port 62h 

XT —Read low nibble, configuration switches, port 62h 

PC—Read spare switches, port 62h 

PC—Read RAM size switches, port 62h 

XT—Unused 

Speaker off 

Speaker on 

Direct speaker control through bit 1 
Speaker control through 8253 timer (channel 2) 


You use I/O port 62h to input a variety of system information (see table 18.5). 


Scanned by CamScanner 



Table 18.5. Meaning of I/O port 62h bit settings. 

Bits 

76543210 

Meaning 

1 

RAM parity error 

1 

Expansion slot error 

7 

8253 timer channel 2 output 

7 

PC—Cassette data input 

X 

XT—Unused 

777? 

PC—Input according to bit 2. port 6lh 

???? 

XT—Input according to bit 3. port 6lh 

1/0 port 63h is used as a mode-control register to control the other three I/O 
pons for this device. Table 18.6 details the individual bit settings and their meaning. 

Table 18.6. Meaning of I/O port 63b bit settings. 

Bits 

76543210 

Meaning 

0 

Port active 

1 

Port inactive 

00 

Port 60h mode 0 

01 

Port 60h mode 1 

10 

Pon 60h mode-2 

0 

Port 60h used for output 

1 

Poet 60h used for input 

0 

Port 62h, bits 7-4 used for output 

1 

Port 62h, bits 7-4 used for input 

0 

Port 6lh mode 0 

1 

Port 6lh mode 1 

0 

Port 61h used for output 

1 

Port 61 h used for input 

0 

Port 62h, bits 3-0 used for output 

1 

Port 62h. bits 3-0 used for input 
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I/O port 64h is used as a status port for the keyboard on the IBM Personal 
Computer AT, as you will learn in the following section. 


Controlling the Keyboard 

Controlling hardware devices directly (through I/O pons) is possible. Because 
the process generally entails more work than most programmers choose to tackle, 
programmers usually elect to use either BIOS or DOS functions to control standard 
devices (see Chapters 20 and 21). Nevenheless, you should be aware that direct 
control of hardware devices is possible. Some programmers may even need to use 
direct-control programming for specific applications. 

This section includes an example of such programming—a program that 
directly controls the keyboard. 1 chose this panicular device because pot every 
reader may have a speaker or a video monitor, but you’re sure to be able td get your 
hands on a keyboard. 

The following sample program reads the information presented by the 
keyboard and then outputs the information as a decimal scan code (originally 
contained in the AL register). 

Although this panicular example is written as a stand-alone assembly language 
program, you can conven and modify it easily if you want to run it as a subroutine 
of a high-level language. 


Page 60, 
Coaaent 

132 

i 

• 

File: 

KEYHARD.ASM 

Author: 

Allen L. Wyatt 

Date: 

9/14/91 

Purpose: 

Intercepts and prints the value returned by the 
keyboard each tiae a key is pressed. Once installed, 
the only way out of this prograa is to turn off 
the coaputer. 


I 

I 


coot 

SEQUENT 

BYTE PUBLIC 'C00E* 


ORG 

1BCM 

1 

KEYHAAD 

PROC 

FAR 
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Chapter 18: Accessing Hardware Ports 



ASSUME 

CS:CODE,OS:CODE 



JMP 

KEV.BEQIN 

;Starts the program 

KB.OATA • 

EQU 

60h 


0TATU0_PORT 

EQU 

64h 


1NPT.BUF..PULL 

EQU 

02h 


UIIjKID 

EOU 

0ADh 


IN^KBO 

EQU 

OAEh 


KEY.'JORMAL 

DO 

0 

;Holds the normal keyboard 




; interrupt vector address 

OK JIM 

DB 

'Program is installed)' 


PNUM PROC NEAR 

PUSH AX 

PUSH BX 

PUSH CX 

PUSH DX 

MOV CX.OFFFFh 

PUSH CX 

MOV CX,10 

DIVLP: MOV DX.B 

DIV CX 

AOO DX,30H 

PUSH DX 

CUP AX,0 

JA DIVLP 


NPLOOP: 

POP 

AX 

;Qet number back 


CMP 

AX.BFFFFh 

;Is it our ending flag? 


JE 

PNUMJEXIT 

;Yes, so go on our way 


CALL 

PCHAR 

;Go print the character 

i 

JMP 

NPLOOP 

;Oo next one 

PMUM_EXIT: 

POP 

DX 



POP 

CX 



POP 

BX 



POP 

AX 



RET 

PNUM ENDP 


;Push our ending flag 
;Always dividing by 10 

;Change to ASCII character 
;Save remainder 
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PCHAR 


PCHAR 

I •••••••••• 

SEND_IT 

SIO: 

SENO_IT 

• «•••••••*• 

I 

NEW_KBO_INT: 

GET KB STAT: 


PROC 

NEAR 

PUSH 

AX 

PUSH 

BX 

MOV 

BH.0 

MOV 

AH.OEh 

I NT 

10h 

POP 

BX 

POP 

AX 

RET 


ENDP 



;Display character 
;BIOS interrupt 


PROC 

NEAR 

PUSH 

AX 

CLI 


IN 

AL,STATUS_PORT 

TEST 

AL,INPT_BUF_FULL 

L00PN2 

SIO 

POP 

AX 

OUT 

•*1 T ATUS_POPT, AL 

STI 


RET 


ENOP 



PUSHF 

PUSH 

AX 

MOV 

AL,DIS_KBD 

CALL 

SEND,IT 

CLI 

IN 

AL,STATUS_PORT 

TEST 

AL,INPT_BUF_FULL 

LOOPNZ 

GET_KB_STAT 

IN 

STI 

AL,KB_DATA 

TEST 

AL,8®h 

JNZ 

END IT 


;Save byte to send 
;Disable interrupts 
;Get Keyboard status 
;Is the coding complete? 
;No, so continue waiting 
;Retrieve byte to send 
;Send the byte 
;Enable interrupts 


;Save the flags 
;0nly messinr with AX 


;Go disable keyboard 

;Disable interrupts 
;Get keyboard status 
;Is the coding ccrplete? 

;No, so continue waiting 
;Yes, so get code 
;Enable interrupts 

;Is it an acknowledgment? 
;Yes, so ignore it 
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END IT: 


KEY BEGIN: 


PUSH 

AX 

MOV 

AL,'A' 

CALL 

PCHAR 

MOV 

AL, L' 

CALL 

PCHAR 

MOV 

AL,‘* * 

CALL 

PCHAR 

POP 

AX 

MOV 

AH,0 

CALL 

PNUM 

MOV 

AL ,13 

CALL 

PCHAR 

MOV 

AL.10 

CALL 

PCHAR 

MOV 

AL<20h 

OUT 

20h,AL 

MOV 

AL,ENA_KBO 

CALL 

SENO_IT 

POP 

AX 

POPF 


IRET 



MOV 

AL,9h 


MOV 

AH,35h 


INT 

21h 


MOV 

SI,OFFSET 

KEY_NORMAL 

MOV 

ISIJ.BX 


MOV 

(SI>2),ES 


MOV 

AX.CS 


MOV 

OS, AX 


MOV 

OX,OFFSET 

NEW_KBO_INT 

MOV 

AL,9h 


MOV 

AH,25h 


INT 

21h 


MOV 

OX.OFFSET 

OK.MSG 

MOV 

AH,9 


INT 

21h 


MOV 

OX,OFFSET 

KEY.BEGIN 

INT 

27b 



Save code 
Print 'AL=' 


Retrieve code 

Only want AL 

Print decimal vali-' 

Print r*r r i a g e return 

Print line feed 


Signify end of interrupt 


Go enable keyboard again 

Restore AX register 
and the flags 


;Get keyboard interrupt 

;Store it here 
;Offset address 
;Segment address 
;New segment address 

;New offset address 
;Change keyboard vector 
; to point to newjcbo.INT 

;Installation complete 
;Print message at DS:OX 

;End of resident portion 
;Terminate but stay resident 
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KEYHARD 

ENOP 


1 

CODE 

ENDS 



END 

KEYHARD 


After it has been entered, assembled, and executed, this program takes control 
of the keyboard by redirecting the keyboard interrupt vector to the new interrupt 
handler, new_kbd_int. This handler intercepts and prints the decimal value of every 
keystroke; thus, every key on the keyboard returns a code, with no intervening 
translation by BIOS. 

Because this routine prints the keyboard scan code for every key without 
exception, the only way to disable the program is to turn off the computer. This 
routine, although of limited value and usefulness, does give you a rudimentary way 
to control the keyboard. 

Notice that this program directly reads and interprets signals from I/O ports 
60h and 64h. Because the program was designed to work on an IBM Personal 
Computer AT (including 386 machines), the address values may be different if you 
are using a different type of computer. 


Controlling the Speaker 

This example, which shows how you can control the speaker directly, uses 
both the 8253 timer and the 8255A PPI. The warble subroutine provides a good 
sound for error routines; Boop provides a gentle sound when the wrong key is 
pressed. 

You can call these routines directly from C. To modify them so that they work 
with compiled BASIC or Pascal, simply change the language specification in the 
.MODEL declaration. 

Page 60,132 
Comment | 


File: SOUND. ASM 

Author: Allen L. Wyatt 

Date: 0/14/Ml 

Purpose: Provides common error sounds from C. 

Format: WarbleO 

Boop<) 

*******•••••••••••••••••••••••••••••••••••«•••••••••••I 

I 
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PUBLIC 

Warble 



PUBLIC 

Boop 



.MOOEL 

anall, c 


• _ _ _ _ 

1 . 

.COOE 



warble 

PROC 

/ 




IN 

AL,61h 

;Save speaker port contents 


PUSH 

AX 



MOV 

DX,0Bh 


MAIN: 

PUSH 

OX 



MOV 

BX.477 

; 1,193,180 / 2500 


CALL 

Warboom 



MOV 

CX,f 

;Highorder wait value 


MOV 

DX,61A8h 

;Low*order wait value 


MOV 

AH,86h 

;Wait service 


I NT 

15h 

• 


MOV 

BX.36 

;1,193,180 / 32767 


CALL 

Warbcoa 



MOV 

CX.t 

;High-order wait value 


MOV 

DX,61A8h 

;Low-order wait value 


MOV 

AH.BBh 

;Wait service 


INT 

ISh 



POP 

OX 



OEC 

DX 



JNZ 

MAIN 



POP 

AX 

;Restore speaker port 


OUT 

61h,AL 

; contents (turn it off) 


RET 


• 

Warble 

• 

ENDP 



Boop 

PROC USES AX BX CX 



IN 

AL,61h 

;Save speaker port contents 


PUSH 

AX 
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Boop 

MOV 

CALL 

MOV 

MOV 

MOV 

I NT 

POP 

OUT 

RET 

ENDP 

BX.6818 

Warbcom 

CX,03h 

DX,0D04h 

AH,86h 

15h 

AX 

61h,AL 

;1,193,180 / 175 

;High-order wait value 
;Low-order wait value 
;Wait service 

;Restore speaker port 
; contents (turn it off) 

1 

Warbcom 

PROC 




MOV 

AL,10110110b 

;Channel 2, write LSB/MSB, 


OUT 

43h,AL 

; operation mode 3, binary 


MOV 

AX, BX 

;Send counter LSB 


OUT 

42h,AL 



MOV 

AL, AH 

;Send counter MSB 


OUT 

42h,AL 



IN 

AL,61h 

;Get 8255 port contents 


OR 

AL,00000011b 

;Enable speaker and use 


OUT 

6lh,AL 

; clock channel 2 for input 


RET 



Warbcom 

ENDP 



1 

END 


- 


The root of these subroutines is the procedure Warbcom, which turns on the 
speaker at a specific frequency, specified in BX. The procedure sets channel 2 of 
the 8253 timer chip (ports 42h and 43h) and then tie$ timer output to speaker input 
through the 8255 PPI (port 6lh). 

L nlike many other port addresses (which may change with succeeding genera* 
tions of computers), the port addresses used in SOl-ND.ASM have been left 
unchanged by IBM. Because of this, the routines should work cn any IBM PC or true 
compatible 

One pan of this routine—the BIOS service used to introduce a delay in the 
routine—may cause problems on older versions of the PC If some son of delay were 
not present, the routine would finish so quickly that >Ou v»ould not be able to hear 
anv sound at all. This delay service is only available beginning with the PC AT. 
however (see Chapter 20. Accessing BIOS Services ) If you are using an oiuer 
model of computer, you will have to make changes in the delav coding 
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To test these routines, use the following C program: 

/• File: TESTSND.C 

• Author: Allen l. Wyatt 

• Date: 9/14/91 

• Purpose: Program to test the calling of sound routines 

•/ 

^include <stdio.h> 

extern void warble(); 
extern void Boop(); 

void main() 

{ unsigned char a; 

printf ('Press any key to test Boop'); 
a = getchar(); 

Boop(); 

printf ('Press any key to test Warble'); 
a * getchar(); 

Warble(); 

) 


Video Controller Ports 


The addresses of the video controller ports vary, depending on the adapter 
card you are using (see table 18.7). 


Table 18.7. Port address ranges for adapter cards. 

Adapter Card 

Port Address Range 

Monochrome 

3BOh-3BBh 

CGA 

3DOh-3DCh 

EGA or VGA 

3BOh-3DFh 


Your programs can determine which card is in use and modify their behavior 
accordingly. This section simply outlines some of the specific port uses—mono¬ 
chrome and color. (For an in-depth discussion of this process, refer to Chapter 17.) 
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The Monochrome Adapter 

Although IBM lists the pon addresses from 3B0h to 3BBh as being reserved for 
the monochrome adapter, the only ports used to control the monochrome display 
adapter are 3B4h, 3B5h, 3B8h, and 3BAh. The adapter does not use 3B0h through 
3B3h, 3B6h, and 3B7h, and ports 3B9h and 3BBh are reserved. 

Port 3B4h, the index register, is used to specify the register to be accessed 
through port 3B5h. You use the OUT instruction to output the desired register 
(0 through 17) to this port. 

POrt 3B5h, the data register, is used for communication with the adapter’s 
internal registers. The desired register is specified through port 3B4h. Table 18.8 
details the individual adapter registers. 


Table 18.8. The internal monochrome display-adapter registers. 

Register 

Use/Meaning 

0 

Total horizontal characters 

1 

Total displayed horizontal characters 

2 

Horizontal sync position 

3 

Horizontal sync width 

4 

Total vertical rows 

5 

Vertical scan line adjust value 

6 

Total displayed vertical rows 

7 

Vertical sync position 

. 8 

Interlace mode 

9 

Maximum scan line address 

10 

Soji line at which cursor starts 

11 

Scan line at which cursor ends 

12 

High-byte start address 

13 

Low-byte start address 

14 

High-byte cursor address 

15 

Low-byte cursor address 

16 

Light pen (high byte) 

17 

Light pen (low byte) 
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Port 3B8h, the CRT control port, Is set during power-up and should never be 
changed. Only three bits in the byte are significant (see table 18.9). 


Table 18.9. Bit meanings In monochrome adapter mode-control register, 
port 3B8h. 

Bits 

76543218 

Meaning 

XX 

Not used 

8 

Disable blink 

1 

Enable blink 

X 

Not used 

8 

Video disable 

1 

Video enable 

XX 

Not used 

1 

80 x 25 display mode 


Port 3BAh, the CRT status port, is a read-only address. This byte has ony two 
significant bits, with bit 0 (when dear) indicating that video is enabled. Bit 3 is set 
when a vertical retrace condition exists. 


The Color/Graphics Adapter 


IBM lists the port addresses from JDOh to 3DFh as being reserved for the 
color/graphics adapter. But, as with the monochrome adapter, the oototfgraJ> h “* 
adapteruses only some of these ports, 3D4h, 3D5h, and 3D8h through 3DCh are the 
only ports used to control the color/graphics adapter. 


Port 3D4h, the index register, is used to specify the register to be accessed 
through port 3D5h. The desired register (0 through 17) is output to this po . 

Port 3D5h, the data register, is used for communication with the adapter s 
internal registers. The desired register is specified through port 3D4h. 


Because both adapters use the same 
meanings for the color/graphics adapter are 
display adapter (refer to table 18.8). 


chip for display control, the register 
identical to those for the monochrome 
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Not used 

Disable blink 

Enable blink 

Normal resolution 

High resolution (640 x 200) 

Video disabled 

Video enabled 

Color mode 

Black-and-white mode 

Alphanumeric mode 

320 x 200 graphics mode 

40 x 25 alphanumeric-display mode 

80 x 25 alphanumeric-display mode 


Port 3D9h the color-select register, is used to specify the colors used in vari¬ 
ous display modes. Only the lower sue bits are significant (see table 18.11). 

Port 3DAh, a read-only address, is the CRT status port. This byte has only four 
significant bits, which are shown in table 18.12. 

Port 3DBh, a strobe, is used to dear the light-pen latch anv writing tn thu ™r* 
dears bi, 1 a, po„ 3DAh. For, JDCh is a s [rol fu«d <o pLe7«h*™Xn bS, 
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Table 18.11. Bit meanings in color I graphics adapter color-select register, 
port 3D9b. 


Bits 

76543210 

Meaning 

XX 

Not used 

1 

Selects cyan/magenta/white color set 

6 

Selects green/red/brown color set 

1 

Selects intensified color set in graphics modes, or 
background colors in alphanumeric-display mode 

1 

Selects intensified border color in 40 x 25 alpha¬ 
numeric-display mode, intensified background color 
in 320 x 200 graphics mode, or red foreground color 
in 640 x 200 graphics mode 

1 

Selects red border color in 40 x 25 alphanumeric- 
display mode, red background color in 320 x 200 
graphics mode, or red foreground color in 640 x 200 
graphics mode 

1 

Selects green border color in 40 x 25 alphanumeric- 
display mode, green background color in 320 x 200 
graphics mode, or green foreground color in 640 x 

200 graphics mode 

1 

Selects blue border color in 40 x 25 alphanumeric- 
display mode, blue background color in 320 x 200 
graphics mode, or blue foreground color in 640 x 200 
graphics mode 


Table 18.12. Bit meanings in color/grapbics adapter status register, port 3DAb. 

Bits 

76543210 

Meaning 

xxxx 

Not used 

1 

Vertical retrace condition 

0 

Light pen triggered 

i 

Light pen not triggered 

i 

Light pen trigger set 

0 

Video disabled 

i 

Video enabled 
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The EGA and VGA Adapters 

Although IBM lists the port addresses from 3B0h to 3DFh as being reserved for 
the EGA and VGA adapters, only a few of the ports are actually used to control the 
adapters. The actual ports used will vary, depending on whether you are using the 
adapters in monochrome or color mode. Tables 18.13 through 18.17 show the 
various port addressing and meanings for this class of adapter. 

Table 18.13. The port address for EGA and VGA adapters. 

Address Meaning __ 

3B2h Input status register 1 (monochrome mode) 

3B4h CRT controller address register (for monochrome mode; see 

tabf-18.14) 

3B5h CRT controller data register (for monochrome mode; see 

table 18.14) 

3BAh Feature control register (monochrome mode) 

3C0h Attribute address register (see table 18.15) 

3C2h Miscellaneous output register or input-status register 0 

C4h Sequencer address register (see table 18.16) 

3C5h Sequencer data register (see table 18.16) 

3CAh Graphics 2 position register 

3CCh Graphics 1 position register 

3CEh Graphics-control address register (see table 18.17) 

3CFh Graphics-control data register (see table 18.17) 

3D2h Input-status register 1 (color modes) 

3D4h CRT controller address register (for color modes; sec 

table 18.14) 

3D5h CRT controller data register (for color modes; see table 18.14) 

1 

3DAh Feature control register (color modes) 


f 
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Table 18.14. CRT controller data-register index settings for port 3B5b (mono¬ 
chrome) or port 3D5b (color). These registers are accessed by writing the index 
value to the CRT controller address register at 3B4b (monochrome) or 3D4b 
(color). 

Index Use/Meaning ___ 

0 Total horizontal characters 

1 Total displayed horizontal characters 

2 Horizontal sync position 

3 Horizontal sync width 

4 Total vertical rows 

5 Vertical scan line adjust value 

6 Total displayed vertical rows 

7 Controller overflow 

8 Interlace control 

9 Maximum scan line address 

10 Scan line at which cursor starts 

11 Scan line at which cursor ends 

12 High-byte start address 

13 Low-byte start address 

14 High-byte cursor address 

15 Low-byte cursor address 

16 Vertical retrace start or light-pen high byte 

17 Vertical retrace end or light-pen low byte 

18 Vertical display enable end 

19 Logical screen line width 

20 Underline scan row 

21 Scan line at which vertical blanking starts 

22 Scan line at which vertical blanking ends 

23 Mode control 

24 Scrolling line compare value 
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Table 18.15. Index settings for attribute-control register at port 3C0b. 


Index 

Use/meaning 

0-15 

Color palette to use 

16 

Display-mode control 

17 

Border-color selection 

18 

Color-plane control 

19 

Horizontal-shift control 



Table 18.16. Sequencer data-register index set tings for port 3C5b. These regis¬ 
ters are accessed by writing the index value to the sequencer address register at 
3C4b. 



Table 18.17. Graphics-control data-register index settings for port 3CFb. These 
registers are accessed by writing the index value to the grapbics-control address 
register at 3CEb. 


Index Use/Meaning 


0 Set/reset 

1 Enable sec/reset 

2 Color compare 

3 Data rotate value 

4 Memory plane to read 

5 Mode register 1 

6 Mode register 2 

7 Ignore color compare 

8 Bit mask for plane changes 
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As you can probably imagine, the overall use and programming of the EGA 
/VGA registers can become extremely complex. IBM produces an EGA technical 
reference that is worth getting if you plan on doing any register-level programming 
of these adapters. 


Printer Ports 

he line-printer interface ports vary according to the number of printer 
interface cards installed in the system. Normally, the three printer ports are 
addressed as indicated in table 18.18. 


Table 18.18. Normal printer-port addressing. 

Designation 

Port Address Range 

LPT1: 

3BCh-3BFh 

LPT2: 

378h-37Fh 

LPT3: 

278h-27Fh 


The addresses shown in table 18.18 arc general guidelines, and will vary from 
installation to installation. For example, if instead of installing a printer interface 
that uses the addresses normally assigned to LPT1you install an interface card that 
uses one of the other port ranges, that card becomes known to the system as LPT1:. 

The first port in each address range (3BCh, 378h, or 278h) is used to output 
information to the printer. The bits of information are output direedy on the parallel 
port. Bit 0 corresponds to pin 2, bit 1 to pin 3, and so on through bit 7, which 
corresponds to pin 9 of the parallel connector. 

Port 3BDh (or 379h. or 279h) is the printer-status register. The bits at this port 
indicate the status of various line signals for the parallel connector. The meaning of 
each bit is indicated in table 18.19. 
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Table 18.19. Bit meanings for parallel-printer adapter status register, port 
3BDh/JT9h/2"9b. 


Bits 

76543210 


Meaning 


Primer busy 

Acknowledged 

Out of paper 

On-line (primer selected) 

Printer error 

Not used 

Time out 


Port 3BEh (or 37Ah, or 27Ah) is the printer-control register. The bits at this port 
are used to control the printer, as indicated in table 18.20. 


Table 18.20. Bit meanings for parallel-printer adapter control register, port 
3BEb/3 7Ah/2 7Ah. 


Bits 

76543210 


Meaning 


Not used 

Enable IRQ7 interrupt for printer acknowledge 

Printer reads output 

Initialize printer 

Enable auto-linefeed 

Output data to printer (strobe) 


The remaining pons (3BFh, 37Bh through 37Fh, and 27Bh through 27Fh) are 
not used by the parallel interface. 
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Asynchronous Communications Ports 

asynchronous iiuerface^ards^insialled' 1 ^ •hc'syMtm.^i^narM^Bios'arKrDOS 
*“0* "° m ° re ,hln communications pons ,o be used (see tabfe W 2 ?) 

Table 18.21. Normal pr inter-port addressing. 

Designation 


COM1: 

3F8h-3FFh 

COM2: 

2F8h-2FFh 

COM3: 

3E8h-3EFh 

COM4: 

2E8h-2EFh 


.. . “*>»« 18 21 lists the addresses for four communications ports 

° Ugh neilher BIOS nor DOS supports the addresses for COM3: and COM4 

rL r UniCa u d ° SUpP ° rt four commu nications ports; softwanl 

can be written to enable use of the two additional ports 

comm^n^nlll 6 intricacics J md complexities of programming for asynchronous 
Dons their aSt0und,ng> a dcu,led explanation of the communications 

haiaAr f k ’ pro £ ramm,n 8* and functions is best left for another book The 
balance of th,s section simply details the meanings of the ports used by^nchV^ 
nous communications devices. y ^ cnrt> 

r 

7 of mnrnh \ 0rd ‘ nsui,y uscd to tfansm ' t and receive data, can boused also (if bit 
po is set) to specify the low-order byte of the baud-rate divisor. 

devicJ^rh#» > H| jd rat f USCd l ° Spccify the baud ratc of idie communications 

r^d£ in * nUn ? Cr that ’ diVidCd imo ** dock spccd of a device 

results in the proper number of birs-per-second for the baud rate of that device. * 

nnrr u** ^ !* U#ed for different purposes. If bit 7 of port 3FBh is set this 

po used to specify the high-order byte of the baud-rate divisor. 

divion Tab,C 18,2 i dctaUs several popular baud rates and their proper baud-rate 
ports **** addresscs shown are for COM 1:. Other communications 

2E9h/2E8h^ *** ** Correspondin 8 P° n addresses of 2F9h/2F8h, 3E9h/3E8h, or 
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Table 18.22. Baud rate 

divisor settings for standard 1.8432 MHz clock speed. 

Baud-Rate Divisor 
MSB LSB 

3P9b 3F8h 

Resulting Baud Rate (bps) 

4 

17h 

110 

1 

80h 

300 

0 

60h 

1,200 

0 

30h 

2,400 

0 

18h 

4,800 

0 

OCh 

9,600 

0 

06h 

19.200 

0 

Olh 

115,200(maximum possible) 


The proper procedure’ for setting the baud rate is to set bit 7 of port 3FBh, 
output the proper divisors to the appropriate pons, and then clear bit 7 of port 
3FBh. 

If bit 7 of port 3FBh is dear, port 3F9h serves as the interrupt-enable register. 
The interrupt-enable register lets you specify which communications events will 
generate Interrupts to the microprocessor. The bit meanings for this register are 
indicated in table 18.23- 


Table 18.23. Bit meanings for the interrupt-enable register, port 3F9b (or2F9b, 
3E9b, or 2E9b). 

Bits 

70543210 Meaning 

eeee Not used, set to 0 

1 Enable interrupt on modem status change 

1 Enable interrupt on receive line status rhang ^ 

1 Enable interrupt on transmit holding register empty 

1 Enable interrupt on data available 


Port 3FAh is the interrupt-identification register. When the microprocessor 
receives an interrupt generated by the communications device, the program reads 
this register to determine exactly what caused the interrupt. Only the three least 
significant bits are meaningful (see table 18.24). 
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TabU 18.24. Bit meaningsfbr The interrupt-identification register Oort IF Ah 
(or2FAb,3EAb,or2EAb). ^ 

Bits 

78543216 

Meaning 

QiQOQ 

Not used, set to u 

ii 

Receive line status interrupt 

it 

Received data available 

•i 

Transmit holding register empty 

M 

Modem status change 

1 

Interrupt not pending 

• 

Interrupt pending 


Port $FBh, the line-control register, is used co specify the format of the data 
transmitted and received through the communications port. Table 18.25 lists the 
meanings of the bit settings for this register. 


TabU 18.25. Bit 
3EBb, or 2EBb) 

meanings for the line-control register, port 3FBb (or 2FBb, 

Bits 

76543210 

Meaning 

• 

Normal access to ports 3F8h/3F9h 

1 

Use ports 3F8h/3F9h to specify baud ratc divisor 

• 

Normal operation 

1 

Transmit break condition (constant SPACE) 

• 

Parity held at value in bit 4 

1 

Parity operates normally 

• 

Odd parity 

1 

Even parity 

• 

Parity disabled 

1 

Parity enabled 

• 

1 stop bit 

1 

2 stop bits (1.5 if bits 0-1 are clear) 

00 

5-bit data length 

•1 

6-bit data length 

16 

7-bit data length 

11 

8-bit data length 
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port 3FCh, the modem-control register, is used for controlling the modem 
interface The bit meanings for this register are detailed in table 18.26. 


Table 18 26. Hit 
3ECh, or 2ECh). 

meanings for the modem-control register, port 3fCh (or 2hCb, 

Bits 

7654321 © 

Meaning 

© 0 © 

Not used, set to 0 

© 

Normal modem functioning 

1 

Operate in loop-back test mode 

1 

“User 2" bit, must be “1” for operation of 8250 
interrupt signals 

© 

“User 1" bit, forces modem reset if “1" 

© 

RTS clear 

1 

RTS set 

© 

DTR clear 

1 

DTR set 

Port 3FDh, the line-status register, is used to indicate the condition of data 

transfer. The meanings of the bits in this register are detailed in table 18.27. 

Table 18.27. Bit meanings for the line-status register, port 3FDb (or 2FDb, 

3EDh, or 2DCh). 


Bits 

76543210 

Meaning 

© 

Not used, set to 0 

0 

Transminer shift register full 

1 

Transmitter shift register empty 

© 

Transmitter holding register full 

‘ 1 

Transmitter holding register empty 

1 

Break condition detected 

1 

Framing error detected 

1 

Parity error detected 

1 

Overrun error detected 

© 

No character readv 

4 

1 

Received character ready 
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modem-control lines. .M^ho^TK^M^nicanin^. * ,hc "»« <* «* 

3EEh, or 2DEb) U meanhlgS f 0r the modern-status register, port JF£b (or 2FEb, 



Receive line signal detected 
Ring detected 
DSR set 
CTS set 

Change in receive line signal detect stale 
Change in ring indicator state 
Change in DSR state 
Change in CTS state 


‘scratchpad "' ly ' ' h ' Communi « tio '' s device u 5es port 3FFh internally as a 


Summary 


This chapter discussed the organization and use of hardware ports. Hard wan- 
devices? ne f CSSary for com P ut crs to be able to communicate with such outside 

yoT^ 

insJaio^r ^ C deV,CCS difCCt,y (lhfOUgh the IN 2nd ° UT mnemonic 

devir J° USC hardware P° rts properly, you must know which ports are used by the 
^cyo uw , n ,, OC! >n , ro , Cenain devjces 5uch „, hc 

and st andardized hardware-port addresses that can be readily accessed 

P grammed through assembly language. 

relesPsnf 1 ^ 1 "T"' r01 ° f,heindividualdevi « h “drawbacks.however Future 
accents . ° r ™ lure 8 cnerat <ons of computers may abandon the currently 

»S.h Un , dird . ,/0 addreS5es in favor of * <“»«* 5un dard. In that even, 
The BIOS lt d,rectly c °ntrols devices through I/O ports would have to be changed, 
vagaries of ch scrv * ccs in Chapters 20 and 21 insulate programmers from such 
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Working with Disk 

Drives 

Ms p dTySS!"rrr seem to do at least some work with 
information, or ‘youn^to '£ ,nf0m,a “° n *» ~ ad 

mos, from 

handle Working with disk files The third dn ft,nc,lons or hbraiy routines to 

e “Uy &om higj. level languages ^ “nno. be done 

languag^ l *TlI«^ t ^^|| l |^ l ^J > ^^'^ *T “ h 0 "™ fl ° PP> ’ d ‘ SkS b ° m as “ mbl >' 
-guage, to provide die 

DOS Functions for Disk Access 

BIOS a^dDOSfunalo^The and 2 *’ you wUI Kc tha < «•*« « many disk-reUted 
Me*. The fun«im£•“* fun { Uons to handle ^'b subdirectories and 
fotmattingduks 3 l ni«^ , ^ < 2 h^B l | 05 r ^^'^ s bowever ' ^ "* 


Q Interrupt 13 h, service 17 h 
Q lntc *Tupt i 3 h. service 18 h 
Q * nter njpt I 3 h, service 5 
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Z* HI: Applying A»^ mblv Language .cchniqu^ 

, K fvr»f of disk you want to format, the 
The first function enables you to se ty allows you to format a 

second specifies ,he type of media berngue^ the «hn ■ f floppy disk 

track. With a program built around these services, yo 
you want. 

Specifying the Disk or Media Type 

Two functions do this task: lntc ^* t ^ 1 ^ e a most n recent > addition to the 
computers may not support this SDCCi fy’,ne number of sectors per track in 

BIOS. Specifically, this function is u CO m put cr does not fully support this 

the disk you ^ J sk base table direedy to change the number 

- — - - - ^^Uwhichenahles 
Most computers In use today *tofdinct-access storage device 

Th c DASD type can be any of the values shown in 

table 19.1. 



360K disk in a 360K drive 
360K disk in a 1.2M drive 
1.2M disk in a 1.2M drive 
720K disk in either a 720K or 1.44 M drive 


Notice that then:. no DASD type for ^ ££££5 

tsszsz 

not allow formatting of 1.44M disks. 
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The Disk Base Table 


If your system does not support Interrupt 13 ldh for setting the number of 
sectors per track, you will need to change the disk base table directly. 

T m' *l i5 r b if se Uble iS 2 “* of P aramctcr s that controls the operation of a disk 
an*e. Most of these parameters help directly govern the drive controller. 

i ™' J”"™ of ,he disk “We can be determined from the vector at 
Interrupt lEhThis vector points to the RAM address where the able begins. In the 
ear y days of DOS (Version 1.0), the disk base table was contained in ROM. Now. this 
able is constructed and vectored when you load DOS so that system changes in DOS 
can be reflected in the disk operation. 

Tat>,C 19 2dctailsthemak eupofthediskbasetable The values.n this uble will 
differ according to the needs of your particular version of DOS or the disk drives 
you use in your computer. 

Table 19.2. The disk base table for controlling disk drives. 


Byte 


Meaning 

Step ratehead unload time in milliseconds 
Head load time, DMA mode in milliseconds 
Motor rum-off delay in clock ticks 
Bytes/sector code 
0 = 128 bytes/sector 

1 = 256 bytes/sector 

2 = 512 bytes/sector 

3 = 1024 bytes/sector 
Sectors per track 

Intersector gap length for read'write operations 
Data length (if sector length not specified) 
Intersector gap length for formatting 
Initial data value for newly formatted sectors 
Head settle time in milliseconds 
Motor start-up time in 1/8 second increments 
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Most of the values in the disk base table never have to be changed. Changing 
them is possible, however, if you want to copy*protect a disk by using some 
nonstandard formatting on the disk. 

If you are formatting a disk and Interrupt 13/18h does not work on your 
machine, the value that needs to be changed is the value at byte 4. This specifies the 
number of sectors on a track, and is referenced by the BIOS track*formattlng 
function, Interrupt 13/05h. Table 19 3 indicates the proper settings for this field, 
depending on the type of disk you are working with. 


Table 19.3 • Sectors per track for various disk sizes. 

Capacity 

Sectors/Track 

360K 

9 

1.2M 

15 

720K 

9 

1.44M 

18 

9 


Formatting a Track 

Interrupt 13/05h is the BIOS function that allows you to format a track on a 
floppy disk. When you call this function, the registers must be set as shown In 
table 19.4. Notice that there is **0 allowance for setting a specific sector number. 
The function formats entire tracks only, not individual sectors in a given track. 


Table 194. Register settings for Interrupt 13105b. 


Register 

Setting 

AH 

5 

CH 

Track (0*based) 

DH 

Head or side number (O-based) 

DL 

Drive number (A=0, B-1) 

ES:BX 

Address of track address fields 
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You should note also that some BIOS vary the register settings shown in 
table 19.4. For instance, documentation for the BIOS from Phoenix Technologies 
(iiie primary supplier of BIOS chips for IBM clones) indicates that you can also set 
AL to the number of sectors on the track. Since you cannot always count on being 
able to set AL to the number of sectors on the track, however, you should stick with 
»te method of using Interrupt 13/18h or modifying the disk base table. 

Notice from table 19 4 th at ES:BX contains the address of an area referred to 
as the track address fields, a collection of fields that indicate specific information 
about each sector on the track. Some of this information is written to the sector 
header so that the sector being formatted can subsequently be located with read, 
write, or verify operations. 

The track address field consist of four bytes for each sector, on the track. These 
four bytes detail the following information in the following order: 

Cylinder (track) 

Head (side) 

Record (sector number) 

Size code 


In common computerese, the cylinder, bead, and record information are the 
track, side, and sector numbers, respectively. Clearly, the sector number will vary. 
But the track and side numbers are the same for all of the track address fields. These 
sector numbers do not have t6 be in sequential order, either; they can be interleaved 
to enhance disk performance or for some other special purpose Regardless of the 
order denoted by this entry (the record or sector-number field) into the track 
address fields, the sectors are placed physically on the disk In the order Indicated by 
the position of the address field. Although this description may sound confusing, it 
corresponds to physical and logical placement of sectors on the disk. . 


Physically, the sectors are always arranged in sequential order (for example, 
from 1 through 9 for a 360K DS/DD disk). Logically, however, physical sector 1 may 
have a sector address mark that is not l. The following example shows two typical 
interleave schemes in which consecutive logical sectors are placed physically either 
two or five sectors apart. The logical numbers are those entered irjthe address fields. 

Physical order 12345678 9 

Logical order 1 6 2 7 3 ‘ 8 4 9 5 

Logical order 135792468 


IBM microcomputers read sectors from the disk logically (by their sector 
•wfress), not physically (by their placement on the disk). 

The size code is nothing more than an indicator of the number of bytes the 
* ecl ° r *411 contain. The size code may vary from 0 to 3 (sec table 19.5). 
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lUrt III 


: Applying Assembly Language Techniques 


Table 19 5■ Valid size 

codes for use In Interrupt 15105b track address fields. 

Size Code 

Bytes per Sector 

0 

128 

1 

256 

2 

512 

3 

1024 


If you understand ihe makeup of the track address fields, you easily can 
compose the bytes necessaty for formatting any disk For instance if youwere, 
formatting a 360K disk, writing the sectors in sequential order on side 0 of uat* 5, 
the bytes would appear as follows (for clarity, an extra space has been inse 
between every four bytes): 

5012 5022 5052 5042 5052 5062 5072 5082 5092 

If voi j were constructing the same track address fields for an interleaved track 
with an interleave factor of 5. the bytes would appear as follows: 

5012 5032 5052 5072 5092 5022 5042 5062 5082 

Notice that if you want to format an entire disk, you must write the code to step 
through the disk, one track at a time. But that is not all—you must remember that 
DOS needs more than just tracks and sectors to be able to use a disk properly. You 
must also write the information for the boot sector, the FAT, and the directory. 

The boot sector is used by the BIOS in case you try to boot the floppy disk. If 
you are creat ing a system disk, this code can get rather complex and is best left to the 
FORMA T program supplied with DOS If you are creating a data disk, however, the 
boot sector is quite a bit simpler. 

The FAT and the directoty simply need to be set up so that DOS can track files 
stored on the disk. 


A Formatting Routine 

New that you understand what goes into formatting a disk, it is time to give an 
example of the code necessary to format an entire disk Consider the following 
subroutine, which is designed to be called from a C program. It correctly formats a 
360k. 72v>K. or 1 2M disk, including writing the bool sector, FAT, and directory. 
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Don i let the length of this routine scare you away. Although it mav be the 
ongest subroutine presented in th.s book. ,t is not untypical of many assembly- 
anguage subroutines you may develop or encounter during your programming 

One caveat the routine may not work on all machines Why include it. then 5 
Because it is itutructional, showing the proper way to format diskettes according to 
available BIOS information. But the differences between DOS and BIOS from 
machine to machine, and the differences among disk drives, may mean that the 
routine will not work on ail computers 1 wrote, tested, and verified it to work on as 

many computers as 1 could get my hands on—but I could not get my hands on all 
machines. 

If the routine does not work on your machine, and you feel inclined to let me 
ow, I am interested. I am interested also in knowing what changes (if any) you 
institute to make it work. I ’ U even be glad to send you a copy of one of my other books 
if you do this. (Ahh—I love the free exchange of knowledge!) 

That said, here is the routine to format a disk: 

Page 69,132 
Comment | 


File; DISKFUT.ASM 

Author: Allen L. Wyatt 

Date: 10/25/91 

Purpose: To format a floppy disk. Designed to work with C. 

Format: int OiskFmt (unsigned DnveWtd, DType); 

OriveWtd: I if A:, Ilf B: 

DType: Type of disk to format, as follows: 

1=360K in 360K drive 
2*360K in 1.2M drive 
3*1.2M in 1.2M drive 

4- 720K in 720K drive 

5- 720K in 1.44M drive 

Returned value i» one of the following: 

9«No error 

Wnvalld parameter 

2*B«d sector address mark 

3*Write protect error 

4=Bad sector or sector not found 

8*0UA overrun 

B-DttA error 
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10-Bad CRC on disk read 
20-Controller error 
40-Seek failure 
00-Timeout 


PUBLIC DiSkFmt 
.MODEL email, C 


.DATA 


TRUE 

EOU 

•1 


FALSE 

EOU 

0 

• 

BXOSflag 

DB 

00 


CurOisk 

OB 

00 


CurTrack 

OB 

00 


RetryCount 

DB 

00 


FmtType 

DB 

00 

;This info is set from the 

Heads 

OB 

00 

; tables immediately following 

TtlTrecka 

DB 

00 


TtlSectore 

DB 

00 


SecPerClust 

DB 

00 


FAT8ectors 

DB 

00 

, 

DIRSectora 

DB 

00 


FATld 

OB 

00 


FmtMsg 

OB 

'Formatting track 


TrackMsg 

OR 

•00> 



DB 



ConflgTable 

OW 

OFFSET D300in300 

;360K in 360K drive 


DW 

OFFSET D3001M20 

;360K in 1.2U drive 


OW 

OFFSET D120in120 

;1.2U in 1.2U drive 


DW 

OFFSET D7201n720 

;720k in 720K drive 

• 

DW 

OFFSET D7201M44 

;720K in 1.44M drive 

D360in360 

DB 

01 

;Format type 


OB 

02 

;Number of heads 


OB 

40 

;Number of tracks 


OB 

09 

;Number of sectors 


08 

02 

;Sectors per cluster 
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OB 

04 

• 

06 

07 


OB 

0FDh 

300in120 

06 

02 


06 

02 


06 

40 


06 

09 


06 

02 


03 

04 


06 

07 


OB 

0FDh 

)120inl20 

06 

03 


06 

02 


06 

80 


06 

15 


06 

01 

• 

06 

14 


06 

14 


OB 

0F9h 

D720in720 

OB 

04 


OB 

02 


06 

60 


06 

09 


DB 

02 


06 

06 


06 

07 


DB 

0FCh 

O720in144 

06 

04 


06 

02 


06 

80 


DB 

09 


06 

02 


D6 

06 


06 

07 


06 

8FCh 

Recoverable 

D8 

00 

BadSpot 

DB 

00 


Jlotal FAT sectors 
;Root directory sectors 
;FAT id 

;Format type 
{Number of heads 
{Number of tracks 
{Number of sectors 
{Sectors per cluster 
{Total FAT sectors 
{Root directory sectors 
{FAT id 

{Format type 
{Number of heads 
{Number of tracks 
{Number of sectors 
{Sectors per cluster 
{Total FAT sectors 
{Root directory sectors 
;FAT id 

{Format type 
{Number of heads 
{Number of tracks 
{Number of sectors 
{Sectors per cluster 
{Total FAT sectors 
{Root directory sectors 
{FAT id 

{Format type 
{Number of heads 
{Number of tracks 
{Number of sectors 
{Sectors per cluster 
{Total FAT sectors 
{Root directory sectors 
;FAT id 

{Flag: TRUE=recoverable 
{ FALSE^not recoverable 

{Flag: TRUE-bad spots 
; FALSE=none bad 
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ErrorCode 

AddrField 


OB 

00 

{Storage for error code 

DW 

0000 

{Track/side 

OB 

01 

{Sector number 

OB 

02 

{Size code-512 bytaa/aector 

• 

DW 

0000 

{Track/side 

OB 

02 

{Sector number 

OB 

02 

{Size code-512 bytes/sector 

DW 

0000 

;Track/slde 

OB 

03 

{Sector number 

OB 

02 

{Size code-512 bytea/aector 

cm 

0000 

;Track/side 

OB 

04 

{Sector number 

OB 

02 

{Size code-512 bytea/aector 

OW 

0000 

;Track/side 

OB 

05 

{Sector number 

OB 

02 

{Size code-512 bytes/sector 

OW 

0000 

;Track/side 

DB 

06 

{Sector number 

OB 

02 

{Size code-512 bytes/sector 

cm 

0000 

;Track/side 

DB 

07 

{Sector number 

DB 

02 

{Size code-512 bytes/sector 

OW 

0000 

;Track/side 

OB 

08 

{Sector number 

OB 

02 

{Size code-512 bytes/sector 

OW 

0000 

;Track/sidc 

OB 

09 

{Sector number . 

OB 

02 

{Size code-512 bytes/sector 

OW 

0000 

;Track/side 

06 

10 

{Sector number 

DB 

02 

{Size code-512 bytes/sector 

OW 

0000 

;Track/side 
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OB 

06 


11 

02 


• Sector Hunter 

•Size cooe*5i2 bytes/sector 


» 


DiskFmt 


;Track/side 

;Sector number 

;Size code*5i2 bytes/sector 


ow eece 

OB 13 

OB 02 


;Track/sxde 

; Sector number 

;Size code-512 bytes/sector 


ow 0000 

DB 14 

’ OB 02 


;Track/side 

;Sector number 

|Size code=5i2 bytes/sector 


DW 0000 

DB 12 

OB 02 


DW 0000 

OB 15 

DB 02 


Track/sxde 

Sector number 

Size code=5i2 bytes/sector 


• CODE 

PROC USES ES DI SI, DriveV.'id. CTyperWORD 

PUSH DS 

POP ES 


BlOStlag ,0" r ‘' 

t 

AX.OrxveWtd 
ErrorCooe.i 
AX ,3 
Exit 

CurOlsk,Al 

AX.DType 

AX 

AX,5 
Exit 

Bx, OFFSET ConfigTable 

AX, 1 

BX.AX 

SI.iBx] 

DI.OFFSET FrtType 

CX.6 

MOVSB 


Assume IN'T 13/18 is supported 

Assume bad drive passed 
Is it in range? 

No, so exit with error 
Store drive number 
Get the type wanted 
Make it zero-based 
Is it an range? 

No, so exit with error 

;Point to start of table 

Multiply by 2 (table is composed of wuros! 

Adjust offset intc table 

Pjt address in source register 

This is where it goes 

Only need to move 8 bytes 

And move it 
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i 



MOV 

CH.TtlTracks 



MOV 

CL.TtlSectors 



MOV 

DL,Cu r OiSk 



MOV 

AH,l6h 

;Set media type for format 


INT 

13h 

;BIOS services 


JNC 

OF1 

{This service was supported; no error 


CMP 

AH.OCh 

;unknown media error? 


JNE 

Exit 

;No, so exit with error 

; Since the 

INT 13/10 

is not supported on this machine, must set the number of 

; sectors directly in the disk base table. 



MOV 

AH,35h 

;Get interrupt vector 


MOV 

AL.lEh 

;Disk base table vector 


INT 

21h 

;DOS service to get vector 


ADD 

BX,4 

;Offset to sectors per track 


MOV . 

AL,ES:(BX) 

;Get current last sector 


MOV 

BIOSflag.AL 

{Store for later 


MOV 

AL,TtlSectors 



MOV 

BYTE PTR ES:(BX),AL 

;Set for proper sectors/track 


MOV 

AH.0 

;Reset drive 


MOV 

Dl.CurDisk 



INT 

13h 

;BIOS services 

DFl: 

MOV 

CurTrack.l 

;Start at beginning 

FatLoop: 

MOV 

BH,0 

;video page 9 


MOV 

AH, 3 

;Read cursor position A size 


INT 

10h 

;BIOS services 


MOV 

DL,0 

;Set for column 9 


MOV 

AH,2 

;Set cursor position 


INT 

10h 

;BIOS services 


MOV 

AH,9 



MOV 

AL.CurTrack 



CALL 

ToASC 

{Convert to ASCII 

• 

MOV 

TrsckMsg.AX 

{Store ASCII value 

• 

MOV 

• 

OX,OFFSET FatMsg 

{Po.int at message to print 


MOV 

AH,9 

{Output character string 


INT 

21h 

;Go print the string 


CALL 

FatTrack 

;Go format the track 


CMP 

ErrorCode.9 

{Was there an error? 
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JNE 

Exit 

;Yes, so exit early 


INC 

CurTrack 

;8et for next track 


MOV 

AL.CurTrack 

;Qet track just finished 


CMP 

AL.TtlTrecks 

;Has the end been reached 


JLE 

FmtLoop 


Exit: 

CMP • 

BI08flag,BFFh 

;Need to reset disk bass table? 


JE 

El 

;No, so continue 


MOV 

AH,35h 

;Qet Interrupt vector 


MOV 

AL.lEh 

•Disk base table vector 


INT 

21 h 

;D08 service to get vector 


ADO 

BX,4 

;Offset to sectors per track 


MOV 

AL,BI08flag 

;Qet old sector value 


MOV 

BYTE PTR E8:(BXJ,AL 

;Set for proper sectors/track 


MOV 

AH,0 

;Reset drive 


MOV 

OL.CurDisk 



INT 

13h 

;BIOS services 

El: 

MOV 

AL.ErrorCode 



XOR 

AH, AH 

;Leave error code in AX for return 


CMP 

AX, 0 

;Any error? 


JNE 

E2 

;Yee, so don't write prelim stuff 


CALL 

writeBoot 

;Go write the boot record 


CALL 

' WriteFAT 

;Go write the FAT 


CALL 

WriteDIR 

;Go write the directory 

E2: 

RET 



DiskFmt 

• 

ENDP 



; Handle formatting a 

single track 



FmtTrack 

PROC 

USES AX BX CX OX ES 


• 

PUSH 

DS 

;Data and extra segments 


POP 

ES 

; are the same 


MOV 

AL.CurTrack 

;Move track number 


DEC 

AL 

;Allow for 0 offset 


MOV 

AH, 1 

;Counter for heads done 
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FD A: 


F 0 0: 


FO C: 


FmtError: 


FO.Exit: 
FmtTraok 


MOV RetryCount.3 

MOV CL.TtlSectors 

XOR CH,CH 

MOV BX,OFFSET AddrField 

MOV fBXJ.AX 

ADD BX,4 

LOOP FD_B 

MOV AL.FmtType 

MOV DL,CurDisk 

MOV AH,17h 

I AT 13h 

JC FmtError 

MOV ErrorCode,0 

MOV BX,OFFSET AddrField 

MOV DX.AddrField 

MOV DL,CurDisk 

MOV CH.CurTrack 

DEC CH 

MOV AL.TtlSectors 

MOV AH, 5 

INT 13 h 

JC FmtError 

MOV AX,AddrField 

DEC AH 

J2 FD_A 

JNZ FO_Exit 

CALL OoError 

CMP Recoverable,TRUE 

JE FD_C 

DEC RetryCount 

JNZ FD_C 

MOV BadSpot,TRUE 

RET 
ENDP 


{Allow 3 retries/track 
;want to do all fields 

{Starting here 

{Point at next field 


{Set disk type for format 

{BIOS services 

;If error, go handle 

{Assume no error on this track 
{Data area for formatting 
{Set OH to head 
{Set for drive 
{Move track number 
{Track here is 0 based 
{Number of sectors 
{Want to format a track 
;ROM BIOS diskette services 
{If error, go handle 

{Get current track/head 

{Decrement head 

;If zero, loop 

{If not, done with track 


{Was the error recoverable? 
{Yes, do it again 

{Set flag for bad spots 


Handle .* r ™ r# th#t ° CCUP durin ° form *tting a track 
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OoError 

PROC 

USES OX 


MOV 

Recoverable.FALSE 


MOV 

ErrorCode.AH 


PUSH 

AX 


XOR 

AX, AX 


MOV 

DL.CurOisk 


INT 

13h 


POP 

AX 


CUP 

AH,03tt 


JE 

RecovErr 


CMP 

AH'BBh 


JNE 

DE_Exit 

RecovErr: 

MOV 

Recoverable.TRUE 

OE.Exit: 

RET 


DoError 

e 

| ■••••••! 

ENDP 


• 

; Convert 

a binary value in AX into a tw< 

; Will handle numbers 

• 

from • to 99 

ToAsc 

PROC 

USES BX 


MOV 

BL.1t 


OIV 

BL 


ADO 

AX,* 00 1 


RET 


Tt'sc 

ENDP 



;Assume non-recoverable 
;Save error cooe 
;Save for a moment 
;Zero out, reset disk system 
;For the disk in question 
;ROil BIOS diskette services 
;Get it back 

;Was it a write protect? 
;ves, go handle 
;Was it time out? 

;No, so exit 
;Recoverable error 


f .. 

; Write the 

e 

boot sector 

to the disk 


WriteBoot 

PROC 

USES AX BX CX OX ES 



MOV 

BX.SEG BootSector 

;Point to boot sector 


MOV 

ES.BX 



MOV 

AL.SecPerClust . 


, 

MOV 

ES:SecCluS,AL 



MOV 

AH ,0 



MOV 

AL.DIRSectors 



MOV 

CL,16 

;16 directory entries per sector 


UUL 

CL 

;AX > maximum directory entries 


MOV 

ES:RDEntries,AX 



MOV 

AH,0 
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MOV 

AL,TtlSectors 


MOV 

ES:SecTrack,AX 


SHL 

AL, 1 

;2 heads 

MUL 

TtlTracks 

;Now have total sectors on disk 

MOV 

ES:TSect,AX 


MOV 

AL,FATId 


MOV 

ES:MediaID,AL 


MOV 

AL.FATSectors 


SHR 

AL, 1 

;Only need eectors in one FAT 

MOV 

AH,0 


MOV 

ES:SecFAT,AX 


MOV 

AL, 1 

;Only 1 sector 

MOV 

CH,0 

;Track 0 

MOV 

CL, 1 

;Sector 1 

MOV 

DH,0 

{Side 0 

MOV 

DL.CurDisk 

{This disk 

MOV 

BX,0 

;ES:0 is buffer 

MOV 

AH,3 

{Wrl.te sector 

INT 

13h 

{BIOS services 

RET 


* 

writeBoot ENOP 



9 

; Write the FAT to the 

disk 


9 

WriteFAT PROC 

USES AX BX CX DX 01 

ES DS 

MOV 

AL,FATSectors 


MOV 

AH, 0 


MOV 

BL,32 

{Paragraphs per 512 bytes . 

MUL 

BL 

;AX now contains paragraphs needed 

MOV 

BX,AX 


MOV 

AH,48h 

{Allocate memory 

INT 

21h 

{DOS services 

MOV 

ES.AX 

{Put in proper place 

MOV 

BL,FATid 


MOV 

CH.FATSectors ' 

{Clear this many words 

MOV 

CL,0 


MOV 

01,0 


MOV 

AX ,0 

j 

{Want to clear memory area 

REP 

STQSW 

{Store 0s in memory 
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MOV 

AX,0FFFFh 


MOV 

ES:(0),BL 

;Store FAT ID 

MOV 

ES:(1],AX 

{Store filler 

MOV 

AH,FATSectors 

;This many sectors in total FAT 

MOV 

AL,0 

;AX now has pointer to start of seconu 

MOV 

DI.AX 


MOV 

AX,0FFFFh 


MOV 

ES: (DX | 

;Store FAT ID 

INC 

DI 


MOV 

ES:(DI),AX 

;Store filler 

MOV 

AL.CurDisk 

;Write to this disk 

. MOV 

CH,0 

• 

MOV 

CL,FATSectors 

;This many sectors in FAT 

MOV 

DH.0 

• 

MOV 

DL,1 

;Start at sector 1 

PUSH 

DS 


PUSH 

ES 


POP 

DS 

;Block must be at DS:BX 

MOV 

BX.0 


INT 

26h 

{Absolute disk write 

POP 

AX 

;Get rid of flags 

POP 

DS 

;Get back data segment 

MOV 

AH,49h 

• {Release memory block 

INT 

21h 

;DOS services 

BET 



WriteFAT ENDP 

• 



• Writ# the directory 

to the disk 



WriteDIR 

PROC 

USES AX BX CX DX DI 

ES DS 


MOV 

AL,DIRSectors 



MOV 

AH,0 



MOV 

BL.32 

{Paragraphs per SI2 bytes 


MUL 

BL 

;AX noer contains parsgraphs needed 


MOV 

BX.AX 

• 


MOV 

AH,48h 

{Allocate memory 


INT 

21 h 

{DOS services 


MOV 

ES,AX 

;Put in proper place 


MOV 

CH.DIRSectors 

{Clear this many words 
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MOV CL,0 

MOV 01,0 

MOV AX,0 

REP STOSW 

MOV AL.CurDiSk 

MOV CH,0 

MOV CL,DIRSectQr6 

MOV OH,0 

MOV DL,FATSectors 

INC OL 

PUSH DS 

PUSH ES 

POP DS 

MOV BX.0 

INT 26h 

POP AX 

POP P3 

MOV AH,49h 

INT 21h 

RET 

WriteOIR ENOP 


;Want to clear memory area 
;Store 0s in memory 

;write to this disk 

;This many sectors in FAT 

;Allow for sectors in FAT 
;Point to first sector of DIR 


;Block must be at DS:BX 

;Absolute disk write 
,Get rid of flags 
;Get back data segment 

; Release memory block 
;D0S services 


The following routine is the actual code that will be written 
to disk for the boot sector. 


BSeCt SEGMENT PARA PRIVATE 

ASSUME CS:BSect, DS:BSect 

ORG S ;Boot sector will be here 

BootSector: JMP SHORT BootCode 

NOP 

; Note that the following information, between here and BootCode, is the BPB 
; used by DOS. This info is compatible with OOS S, but will also work with 
; earlier DOS versions. 

OB ‘UAL3E 

512 ;Bytes per sector 
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seuClus 

DB 

00 


DW 

0001 


DB 

0? 

Reentries 

DW 

0000 

TSect 

DW. 

0000 

MedialD 

D3 

00 

SecFAT 

DW 

0000 

SecTrack 

DW 

0000 


DW 

0002 


DO 

00000000 


DD 

00000000' 


OB' 

00 


Dl 

00 


DB 

29h 


DD 

00000000 


DB 

11 dup r •) 


DB 

1 FAT12 

BootCode: 

MOV 

AX,7C0n 


MOV 

OS. AX 


MOV 

ES.AX 


MOV 

AH,0Fh 


INT 

I0h 


MOV 

SI,OFFSET BootMsg 

MsgLoop; 

MOV 

AL, (SI 1 


CMP 

AL.Q 


JE 

MsgDone 


MOV 

AH.OEh 


INT 

lOh 


INC 

SI 


JMP 

SHORT MsgLoop 

> r^Do.u: 

MOV 

AH,3 


INT 

16h 


MOV 

AL.13 


MOV 

AH.OEh 


INT 

I0h 


MOV 

Al.,10 


MOV 

AH.OEh 


INT 

i0h 


INT 

19h 


(Sectors per cluster 

;Reserved sectors (boot sector only) 

;Number of FATs 

(Root directory entries 

(Total sectors 

(Media or FAT ID byte 

;Sectors per FAT 

(Sectors per tr?ck 

;Heads 

..Hidden sectors 
(Hugs sectors (if TSect = 3) 

(Drive number, if a hard disk 
(Reserved 

(Extended boot signature 
(Volume serial number 
(Volume label goes here 
(File type 

(Standard loading place for 
; boot st*:tor 


(Get current display mode 
;BI03 services 


(Get next character 
(End of string? 

(Yes, so eno 

(Write text in teletype morie 
(BIOS services 


(Read keyboard character 

(BIOS services 

(Process a carriage return 


(Process a line feed 

;Do a warm boot 
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• BootMsg 


13.18.13.10 

‘ this disk was formatted with a’ 

• program from’,13 ,10 

Using Assembly Language, 3rd edition,’ 

1 by Allen l. Wyatt.*,13,10 

13.10 

This is a non-system disk. Remove 1 

’ this '‘isk‘,13,10 

and press any key to reboot your’ 

* system.’,13,10 
13,10, 39 DUl* (’ ’), § 


BSect 


ENDS 


.‘Boot sector has to end with 
; these bytes, in this order 


Most of this routine Li fairly strai^iitfbrwarj, based on the discussions earlier 
in this chapter. 

. 11 * |°op beginning with FatLoep is used to step through die individual tracts 
TJ’' cod “*^ i re ‘ hi ‘ loop sets up the variables needed in the rest of 
the program by transferring Information from predefined data tables into the final 
data area, based on variables passed from the C program 

. l VS Ktl foroufong. however, takes place in the subroutine FetTr.ck. Here the 

“P “d both sides of a single pack ant formatted. If sn 

riltrt ng form ? tt,n *' "P *o «b«e retries arc perfo.med before 
returning to the C program with an error. 

memo^^Tf ^ "T™ and Writ0OIR ’ "*** a block of 

zrz^ 008 ' ° yt thc memory arca » the block to disk. In the case 

of WriteFAT, the necessary ^AT ID is written at the beginning of each copy of the FAT. 

nt ,rrJ? e fi I“! major . ro ^ tinc ’ WriteB oot, may take some additional explanation. Its 
purpose is to write the boot sector from the end of the program infce BSect seg- 

memro -,de 0, track 0, sector 1 of the disk. This is thc stand^S^ation for the bS 

filled in ^ ** wnrtcn to ^Wt, however, a few variables must be 

““ “ ° f . lhe sector special area is used by DOS, and many 

boo this a^dTdisk ^ CtCfm, !I C *5 Charactcrlstics of the disk. When your system Is 
included in BSect is e^cuted A^i ** r ° U f f nC f in drive thc Programming code 
is prompted to pressTk^o ^ “ d ** '** 
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":x^ra« o “ bnraii " H 

SSF=53SS=S 


The Controlling Program 

The^^cTC^ ' hC/CqUe5 ‘ " ,heSUbrout ‘ n ' 

/* Flit: FMT.C 

* Author: Allen L. Wyatt 

* Otto: 1®/25/91 

* Fi-^pott: Program to format a disk 


•include <ttdio.h> 


txttm short OiskFmt (short, short); 
void main() 

{ unslgntd short CType-a, Drive, Result: 
char Disk-• •*. 
char Temp; 

•*»Ua (Diskl-‘A* fc* Diskl-’B') 

( printf(•\nOrive A or B7: ■); 
Dlak-(getche() 4 0x5F); 

) 


S,1,ct th * VfP* of disk to format in driva %c:\n\Disk); 
1# 36$K di » k in a 364K driveXn*); 

P»* htfc 2 . 360K disk in-a 1.2M drlvaXn*); 

P^lntf(• 3 . t.2il disk in a 1.2M drive\n'); 

printf(• 4 . 72#k disk ? 72tK driveVn*); 

printf(• 5 . 72W < di8k ll( , 144M driveVn’); 

printf(• g. Cancel operativ-' and exit program\n*); 
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while 

{ 


(OType<i :: DTvpe>o) 
p.'intt (’ \nPlease select by number: 

Temp’ = getche(); 

□Type = atoi(&Temp); 


> 

printf(*\n\n*); 


*); 


if (DType!=6) 

{ Drive=0; 

if (Disk== d') Drive=1; 

Result=DiskFmt(Drive, DType); 

printf(*\r*); 
switch (Result) 

{ case 0: 

printf(’Formatting complete\n"); 
break; 
case 1: 

printf ("Invalid request\n"); 

b^eak; 

case 2: _ 

prj.ntf ("Bad sector address mark\n*); 

break; 
case 3: 

printf("Write-protect error\n"); 
brecir; 
case 4: 

printf ("Cab sector or sector not four.d\n*); 
break; 
case 8: 

printf("DMA overrun\n*); 
break; 
case •>: 

printf("DMA error\n"); 
break; 
case 10: 

printf("Bad CRC on disk read\n*); 
break; 
case 20: 

printf("Controller error\n'); 
break; 
case 40: 

printf("Seek failure\n"); 
break; 
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case B0: 

prxntf (■Tiu'eout\n•); 
break; 
default: 

printf ('Unknown error: VAn* .Result); 

) 

> 

) 

This program simply asks the user which disk to format, the one in drive A or 
the one in drive B, and then determines die type of disk and drive being used. Then 
this information is passed to the DiskFmt routine, where the real work is done. 


Summary 

Working with disks can sometimes l»e viewed as a necessary evil of program¬ 
ming. Most disk interaction takes place djrough the facilities of a high-level lan¬ 
guage. Some disk operations, such as formatting a <•kik, cannot be accomplished 
except by using assembly language routines. 

This chapter has discussed, in detail, how to format disks. You saw how BIOS 
accomplishes this, as well as the development of a full program to illustrate the 
process. If you master such a complex, tooic as disk formatting, you have reached a 
major milestone in assembly language programming. You have attained a level of 
competency that will enable you to accomplish virtually any assembly language task. 
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CHAPTER 



Accessing BIOS Services 


B IOS (Basic Input/Output System) is the lowest software level for communicat¬ 
ing with hardware. Because the BIOS software usually is contained in the 
computer’s read-only memory (ROM), BIOS is often referred to as ROM-BIOS. 

The BIOS contains a series of functions that are easily accessible to an outside 
program—such as one you may develop. These functions, which are nothmg more 
than callable subroutines, are invoked through software interrupts Interrupts are 
generated by the assembly language instruction INT, which causes the microproces¬ 
sor to use an address fetched from an interrupt table in low memory as the address 
for this special type of subroutine. 

Specifically, INT pushes the flag(s) register on the stack and then resets the 
interrupt and trap flags. The full return address (CS IP) is placed on the stack and 
then the desired interrupt vector (address) is retrieved from the interrupt table and 
placed in CS:IP. Execution of the interrupt then continues until an I RET instruction 
is encountered, at which point the return address is popped from the stack and 
placed in CS:IP. The flags register is then restored from the stack, and program 
execution continues from the point at which the interrupt svas invoked. 

Notice that the number of the interrupt being invoked determines which 
interrupt address is fetched from the interrupt table. Thus, the full syntax for calling 
an interrupt is 

INT XX 

where XX represents the number of the appropriate interrupt. 
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This chapter covers the BIOS interrupt services, listing in detail the different 
BIOS interrupt numbers and the tasks they perform. (Chapter 21 covers the DOS 
interrupt services.) 

As you may recall, Chapter 18 describes how to access the computer’s 
hardware ports directly. Ordinarily, BIOS does most of this direct accessing. The 
concept of allowing BIOS to perform hardware interfacing, instead of performing 
the interfacing in your software, is readily justifiable. Although the chips that make 
up the computer hardware (or their related port address) may change or vary from 
one computer to another, the BIOS interfaces should not change. Any given BIOS 
function should produce identical results, regardless of which computer you’re 
using. The way BIOS performs a task will differ, depending on the hardware. But 
because of the insulation provided by BIOS, this difference does not affect you, the 
programmer. 

The universality of the BIOS applies only to the world of IBM microcomputers 
or close clones. Some computers that are purported to be IBM-compatible are not. 
And there are different levels of compatibility; some computers are hardware- 
compatible, some are DOS-compatible, and others are BIOS-compatible. The BIOS 
services listed in this chapter should work on any machine that is BIOS-compatible 
with the IBM. 

The interface layer that BIOS introduces between the hardware and software 
levels has definite benefits. The primary benefit should be immediately apparent- 
software development time is greatly enhanced, so programmers can develop 
software more efficiently. Because of the BIOS, you don’t have to develop a different 
interface for every possible hardware combination. Other benefits include the 
security of knowing that your software will work on a variety of hardware configu¬ 
rations. 


The BIOS Service Categories 

The services offered by BIOS can be divideo into several broad categories. 
Generally, these categories are determined by the I/O devices supported by the BIOS 
functions. Some categories, however, contain BIOS functions that deal with the 
Internal workings of the computer rather than an external peripheral. 

The BIOS function categories Include 
O Video services 
O Keyboard services 
O Disk services 
Q Printer services 
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Q Communications services 

□ Date/time services 

□ Cassette tape services 
Q System services 

This section's descriptions of services apply to all IBM-comnatihl, nine 
versions except as noted in the individual write-ups I can't wrifeT^^ “°® 
done design and BIOS, however; its possible Iha“youro™ SEAL'S 

riT P °nrne lf ^ yOU "* U!ing a PS/2 ' n0 “ *» siSniBcant 
were made to the video BIOS service, and that the service oriainaUv used „ 7,,~ 

cassette interface was changed extensively when the PS/2 line was introduced. P *’ 


The BIOS Services 


, °J this Chapter is designed as a convenient reference. Each BIOS 

funedon call Is described in dead, with die following MornutonZjT 

° fi^d U bv n mm n e ’ A n>me b t Sed ° n ** BIOS fi,ncflon nuna selected and 

or otpanded ,o m ° re ~ 

□ Category. The general classification of the function. 

° d^joh^rL^Ti enl, TrL BIOS ^* nction parameters generally are passed 
*n>ugh registers. The expected register settings are defied hoT 

° ^^t n r !T Um ' Kn ° Wln8 how "*•« « ^ed by interrupt, U 
freouentlv r ^ fi pr0pc . r opcration of software. Because BIOS functions^ 
h B ^ m va * ues through registers, such information is detailed 

00(1108 9caion **“* shows ** P^per method for 
thefaJSS*’ DCtaJU ° f lhC purposc ' benefits, and special considerations of 
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The functions arc arranged in ascending numerical order. Kach function can 
be identified bv the primary interrupt number and a service number (l ach service 
niimber IS specified by the contents of the Al I register.) In this notation scheme, any 
1IOS service can be denoted by a hexadecimal number pair, ll/SS, in which // is the 
interrupt number and SS is the service number. For example, the service used to set 
video mode, service 10 0, has an interrupt number of 10h, and a sen ice number 

(specified through AH) of 0. 


Print Screen (Interrupt 5) 

Category: Printer services 
Registers on Entry: Not significant 
Registers on Return: Unchanged 
.Memory Affected: None 
Syntax: 

1NT 5 h ;BI0S print screen interrupt 

Description: To invoke this BIOS interrupt, press PrtSc (to access PrtSc. you may 
need to-press the Shift key) The interrupt causes the ASCII contents of the video 
screen to be sent to the printer. 

Because most programs do not need a verbatim copy of the screen being sent 
to the printer, this interrupt normally is not called by a user program. However, the 
interrupt is designed for this type of use. and there Is no problem in calling it from 
software control. The effect is the same as if the user had pressed die PrtSc key- 

By changing the vector for this interrupt, you can create a custom version of the 
print-screen service or disable it completely. For information on changing 
interrupt vector, see DOS service 21/25 (Chapter 21). 

VCTien you call '.his interrupt, the contents of tnc registers are not significant, 
they remain unchanged on return. This routine does not change the position of the 
video cursor. 

The status of this operation, which is contained in the single byte at memory 
address 50:0. is 1 while printing t.s in progress. The status is 0 if the print operation 
was successful, and 0FFH if an error ocrurred during the last print-screen operation. 
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Set Video Mode (Interrupt lOh, service 0) 

Category: Video services 
Registers on Entry: 

AH: 0 

AL: Desired video mode 

Registers on Return: Unchanged 

Memory Affected: Ordinarily, the video memory area for the desired mode is 
cleared unless the high-order bit of AL is set and an Enhanced Graphics Adapter card 
is in use. 

Syntax: 


MOV AH,0 
MOV Al,3 
1NT 10h 


•Specify service 0 

;80x25 color, TEXT {CGA display adapter) 
;B1G$ video interrupt 


Description: This service is used to set a specific video mode. The acceptable 
' • ,vjUC5 wM1 var ? • depending on the type of display adapter installed in the computer. 
Tahk 20.1 shows the possible settings for video modes. 


Normally, setting the video mode causes the video buffer to be cleared. If you 
are using an EGA or VGA card, however, you can add the value 128 to any video¬ 
mode value to Indicate that the video-display memory should not be cleared . Adding 
12^ is equivalent to setting the high-order bit of AL. 


As new types of display adapters become available, the list of video modes 
sted in table 20.1 probably will change or grow. Depending on the amount of RAM 
available to the display adapter, the colors available with the EGA or VGA card in 
the different video modes will vary. 
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Table 20.1. Video mode settings for BIOS service 10/0. 


Mode Mod'* Display Pixel 

Number Type • Adapter Resolution Characters Colors 


0 

Text 

CGA 

320 x 200 

40x25 

I6(gray) 



EGA 

320 x 350 

40x25 

16 (gray) 



MCGA 

320 x 400 

40x25 

16 



VGA 

360x400 

40x25 

. 16 

i 

Text 

CGA 

320 x 200 

40x25 

16 



EGA 

320 x 350 

40x25 

16/64 



MCGA 

320x400 

40x25 

16 


• 

VGA 

360x400 

40x25 

16 

2 

Text 

CGA 

640 x 200 

80 x 25 

I6(gray) 



EGA 

640 x 350 

80x25 

I6(gray) 



MCGA 

640x400 

80x25 

16 



VGA 

720 x 400 

80x25 

16 

3 

Text 

CGA 

640 x 200 

80x25 

16 



EGA 

640 x 350 

80x25 

16/64 

% 


MCGA 

640 x 400 

80x25 

16 

• 


VGA 

720 x 400 

80x25 

16 

4 

Graph 

CGA/EGA/ 

MCGA/VGA 

320 x 200 

40x25 

4 

5 

Graph 

CGA/EGA/ 

320 x 200 

40x25 

4 (gray) 



MCGA/VGA 

320x200 

40x25 

4 

6 

Graph 

CGA/EGA/ 

MCGA/VGA 

640x200 

80x25 

2 

7 

Text 

MDA/EGA 

720x350 

80x25 

Mono 



VGA 

720 x 400 

80x25 

Mono 

8 

Graph 

PCjr 

160 x ?OQ 

20x25 

16 

9 

Graph 

PCjr 

320 x 200 

40x25 

15 

10 

Graph 

PCjr 

640 x 200 

80x25 

4 

13 

Graph 

CGA/EGA/VGA 

320 x 200 

40x25 

16 

14 

Graph 

CGA/EGA/VGA 

640 x 200 

80x25 

16 

15 

Graph 

EGA/VGA 

640 x 350 

80x25 

Mono 

16 

Graph 

EGA/VGA 

640 x 350 

80x25 

16 

17 

Graph 

MCGA/VGA 

640 x 480 

80x30 

2 

18 

Graph 

VGA 

640 x 480 

80x30 

16 

19 

Graph 

MCGA/VGA 

320 x 200 

40x25 

256 
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Set Cursor Size (Interrupt lOh, service 1) 

Category: Video services 

Register* on Entry: 

AH: l 

Beginning scan line of cursor 
Ending scan line of cursor 

Registers on Return: Unchanged 

Memory Affected: None 

Syntax: 


CH: 

CL: 


MOV AH,1 
MOV CH,0 
MOV PL,7 
INT I0 h 


{Specify service 1 
{Start on scan line 0 
{End on scan line 7 
{BIOS video interrupt 

num hcr of scan 

coiresponds to a Z\*l ‘ET T high ' Ead > ° f — 

paints a character on the video monitor"' IraC, ’ d ^ thc clcc,r ° n beam that 

start wtdentl rhescp^jnot^ aL**** character * XMt d>c cursor should 

vary fro m o to 7 lines (for the CGA^ oHfr ^n 8innm ® and cndln 8 8Can lines, can 
Within the valid numeric «nL J ^ ° ‘° 13 Uncs < for MDA and EGA), 
ending scan lines. If the beginning sraoline^* co / nbination of beginning and 

cursor will wrap around the hotr r . *f ® reatcr dian B»e ending scan line, the 
two-pan c U ^ A T^^c u °p^^ bOX ' ‘ n “ 

the character box occupies only the bottom one or two scan lines in 

EGA. ^ “uw^rT; ST 1 * T ra “ S * b “ <Uffcrend >' •*>“ 

ihat you are using the normal h c"* “ you treat the EGA, provided 

however, you must also change cursor change db P |a >’ siza - 

(stored in the BIOS ram ^ ,, ^es, us,n 8 the character height in pixels 

determine die e^fn^nTn/U^^ °° 485h ' or *™™ d seVvice 11 ) to 
cursor) or 0 (for a block). P *' The Valut can ** ,he same (for a single-line 
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Set Cursor Position (Interrupt lOh, service-2) 

Category: Video services 


Registers on Entry: 


AH: 2 

BH: Video page number 

DH: Cursor row 

DL: Cursor column 

Registers on Return: Unchanged 

Memory Affected: None 

Syntax: 


MOV AH,2 
MOV DH,e 
MOV DL,0 
MOV BH,e 
INT 10h 


Specify service 2 
Place c'"*sor at top left 
corner of screen (0,0) 
Primary text page 
BIOS video interrupt 


Description: This service, which sets the position of the video cursor, is based on 
a screen-coordinate system. Generally, the cursor row, stored in DH. can vary from 
0 to 24. The cursor column, stored in DL, normally varies from 0 to 79 The exact 
range of positions depends on the type of display adapter you are using and the 
current video mode, however. 


If you are using graphics mode, the video page number stored in BH should 
be set for 0. In text modes, which can accommodate more than one video page, the 
number usuullv varies from 0 to 3 Ifyou are operating in 40-column mode, the video 
page number can vary from 0 to 7. The cursor position for each video page is 
independent of the other pages. 



Read Cursor Position and Size (Interrupt lOh, service 3) 

Category: Video services 
Registers on Entry: 

AH: 3 

BH: Video page number 
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Registers on Return: 

3H: Video page number 

CH: Beginning scan line of cursor 

CL: Ending scan line of cursor 

DH: Cursor row 

DL: Cursor column 


Memory Affected: None 
Syntax: 


MOV 

AH,3 

•.Specify service 3 

MOV 

BH,0 

‘•Primary text page 

UT 

1®h 

;BI0S video interrupt 

McV 

CUR_SIZE,CX 

;Save current cursor size 

MOV 

CUR_P0SITI0N,DX 

;Save current fosition 


Description: Use this service to determine the cursor’s current status. Be sure to 
save the values so that, after manipulation, the program can restore the cursor 
condition. 

If you are using graphics mode, the video page number stored in BH should 
be set for 0. In text modes, which can accommodate more than one video page, the 
video page number usually varies from 0 to 3. If you are operating in 40-column 
mode, the video page can vary from 0 to 7. The cursor position for each video page 
is independent of the other pagts. 

In this service (which is the opposite of services 10/1 and 10 / 2 ) the cursor size 
and position for a desired video page number are returned in CX and DX. 

Ordinarily, the scan lines returned in CH and CL will vary from 0 to 7 (for the 
CGA adapter) or from 0 to 13 (for the MDA and EGA adapters). Far additional 
information oh scan-line designations, refer to service 10 / 1 . 

The cursor row returned in DH normally varies from 0 to 24, and the cursor 
column returned in DL varies either from 0 to 39 or from 0 to 79, depending on 
which video mode currently is set. 



Read Light Pen Position (Interrupt lOh, service 4) 

Category; Video services 
Registers on Entry: 

AH: 4 
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Registers on Return: 


AH: Light pen trigger status 

BX: Pixel column 

CX: Raster line (pixel row) 

L)H: Light pen row 

DL: Light pen column 

Memory Affected: None 


Syntax: 

MOV |M,4 ;Specify service 4 

INT I0h ;BI0S video interrupt 

Description: If you have a light pen attached to your computer, this service allows 
you to determine the status of the light pen. Even though the hardware for using a 
light psn exists on the MDA, its use effectively is defeated by the long retention time 
of the phosphor used in monochrome monitors. 

On return from this interrupt, you should check the value in /H. If the value 
is 0, the light pen has not been triggered. Because the othe* - values will be 
meaningless, do not attempt further analysis and action base.d on the light pen's 
status. 

If the value in AH is 1, the light pen has been triggered and two sets of 
coordinates (pixel and text) are returned. The video mode you are using determines 
which set of coordinates you should use: the pixel coordinates are appropriate for 
graphics screens; the text coordinates, for text screens. 

The register pair CX:BX contains the set of pixel coordinates. CX is the raster 
line, or vertical pixel position, which varies from 0 to 199 or, for some EGA inodes, 
from 0 to 349. BX (the horizontal pixel position) can vary from 0 to 319 or from 0 
to 639, depending on the resolution of the video adapter used in the computer 


The accuracy of the pixel coordinates returned by this BIOS service varies. 
Because the vertical (raster line) coordinate is always a multiple of 2. only even lines 
areretumec. even if an odd-number line triggered the pen. Similarly, if the video 
mode currency allows for a horizontal resolution of“320 pixels, the horizontal 
coordinate returned is a multiple of 2. If the horizontal resolution is 640 pixels, the 

c ( oor< ^ natc * s 3 tuultiple of 4. Thus, this BIOS function precludes use of 
a light pen for precise graphics work. 


••oorHinl» U arc worlcin 8 in text mode, you will want to use the other set of light-pen 
.lormaii CS * V° w an< * column (DL) coordinates. The row coordinate 

»*om n t ° m ® lo column coordinate varies either from 0 to 39, or 

° * epeoding on the video adapter. The coordinate for the upper left 

rner of the display area is 0.0. 
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Select Active Display Page (Interrupt lOh, service 5) 

Category: Video services 


Registers on Entry: 


AH: 5 

AL: Desired display page 

Registers on Return: Unchanged 

Memory Affected: This service determines which area of video memory to 
displayed. 7 


Syntax: 


MOV AH,5 
MOV AL,1 
INT ieh 


{Specify service 5 
{Went page 1 video 
{BIOS video interrupt 


Description: Depending on the current display mode and the video adapteryou are 
using, you can use multiple, independent display pages. This BIOS service allows 
you to specify which video page is to be active, or displayed. 

The desired display page is specified in AL This value will vary within a range 
determined by the current display mode and the type of adapter you are using (see 

table 20.2). The video-mode numbers indicated in table 20.2 correlate directly to 
those shown in table 20.1. 


Table 20.2. Video display pages for various display modes and video adapters. 

Mode Number 

Display Adapter 

Page Range 

0 

All 

0-7 

1 

All 

0-7 

2 

CGA 

0-3 


EGA/MCGA/VGA 

0-7 

3 

CGA 

0-3 


EGA/MCGA/VGA 

0-7 

7 

MDA 

0 


CGA/EGA/VGA 

0-7 

13 

EGA/VGA 

0-7 

14 

EGA/VGA 

0-3 

15 

EGA/VGA 

0-1 

16 

EGA/VGA 

0-1 
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between pages. 


Scroll Window Up (Interrupt lOh, service 6) 

Category: Video services 
Registers on Entry: 

AH: 6 

AL; Number of lines to scroll 
BH: Display attribute for blank lines 

CH: Row for upper left comer of window 

CL: Column for upper left comer of window 

DH: - Row for lower right corner of window 
DL: Column for lower right comer of window 


Registers on Return: Unchanged 

Memory Affected: This service modifies the desired video-buffer a xa of the-active 
display page. 

Syntax: 


MOV 

AH,6 

MOV 

AL,3 

MOV 

BH,7 

MOV 

CH,S 

MOV 

CL,5 

MOV 

OH, 15 

MOV 

0L.74 

INT 

I0h 


;Specify service 6 
{Want to scroll 3 lines 
;Normsl white-on-black 
;llpper left ■ 5,6 

{Lower right ■ 16,74 

{BIOS video interrupt 


Description: Use this service (which is the opposite of service 10/7) to selectively 
scroll up portions of the text screen. Only the currently active text display page js 
affected. The number of lines to scroll, contained in AL, is set for the desired value. 
If this value is set to 0, or to a value greater than the height of the specified window, 
the entire window area is cleared. (Using a value 1 greater than the window height 
will dear the window area more quickly than if you use zero, because the routine 
loops until AL decrements to zero regardless of its value at entry.) 


CX and DX should contain the upper left and lower right coordinates for the 
window, respectively. The high byte of each register is the row, normally in the range 
oi 0 to 2-i. The low byte is the column, normally either 0 to 39 or 0 to 79. depending 
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on thceiirrem display mode. It the rectangle specified is inverted so that the value 
in CX is greater than the value in DX, the results will be unpredictable 

35* lnfofTn «‘on scrolled w£the top of the window is lost. The blank lines 
scro cd on the bottom of the window consist of spaces with the character attnbu * 
specified by the byte value in BH. Table 20.3 Usts the character attributes available 
lor a CGA or EGA video adapter; other values may be available, depending on which 
video adapter card you use. 


Table 20.3. Character attribute byte values. 

Foreground 

Background Hex Value Decimal Value 

Black 

Black 

OOh 

0 

Blue 

Black 

Olh 

1 

Green 

Black 

02h 

2 

Cyan 

Black 

03h 

3 

Red 

Black 

04h 

4 

Magenta 

Black 

05h 

5 

Brown 

Black 

06h 

6 

White 

Black 

07h 

7 

Gray 

Black 

08h 

8 

Light blue 

Black 

09h 

9 

Light green 

Black 

OAh 

10 

Light cyan 

Black 

OBh 

11 

Light red 

Black 

OCh 

12 

Light magenta 

Black 

ODh 

13 

Yellow ' 

Black 

OEh 

14 

Bright white 

Black 

OFh 

15 

Black 

Blue 

lOh 

16 

Blue 

Blue 

llh 

17 

Green 

Blue 

12h 

18 

Cyan 

Blue 

13h 

19 

Red 

Blue 

14h 

20 

Magenta 

Blue i , 

15h 

21 

Brown 

Blue 

I6h 

22 

White 

Blue 

17h 

23 

Gray 

Blue 

18h 

24 
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Tahlv -O.i- i rnlhtut.il 


Fy*£r<*titul 

Background 

Light blue 

Blue 

Light green 

Blue 

Light cyan 

Blue 

Light red 

Blue 

Light magenta 

Blue 

>I'IU)VV 

Blue 

Bright vs hue 

Blue 

iM.uk 

Green 

Blue 

Green 

Circen 

Green 

Cyan 

Green 

Red 

Green 

Magenu 

Green 

Brown 

Green 

White 

Green 

Gray 

Green 

Light blue 

Green 

Light green 

Green 

Light cyan 

Green 

Light red 

Green 

Light magenta 

Green 

Yellow 

Green 

Blight white 

Green 

Black 

Cyan 

Blue 

Cyan 

Green 

Cyan 

Cyan 

Cyan 

Red 

Cyan 

Magenta 

Cyan 

Brown 

Cyan 

White 

Cyan 

Gray 

Cyan 


Hex Value 

19h 

lAh 

IBh 

ICh 

lDh 

lEh 

lFh 

20h 

21h 

22b 

23h 

24h 

25h 

26h 

27h 

28h 

29li 

2Ah 

2Bh 

2Ch 

2Dh 

2Eb 

2Fh 

30h 

3lh 

32h 

33h 

34h 

35h 

36h 

37h 

38h 


Decimal Value 
25 


51 

52 

53 

54 

55 

56 
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v hnwnonf 

lidck'^nmnd 

Hex W'.rC 

I h etnull Value 

Light blue 

Cyan 

ifh 

4" 

Light green 

Cyan 

aAh 

58 

Light cyan 

Cyan 

3Bh 

59 

Light red 

Cyan 

5Ch 

60 

Light magenta 

Cyan 

3 Oh 

61 

Yellow 

Cyan 

JEh 

62 

Bright white 

Cyan 

3Fh 

65 

Black 

Red 

4()h 

A* 

Blue 

Red 

4 Ih 

65 

Green 

Red 

4ih 

66 

Cyan 

Red 

4^h 

6“ 

Red 

Red 

4nh 

68 

Magenta 

Red 

45h 

69 

Brown 

Red 

46h 

70 

VlTtite 

Red 

A’h 

71 

Gray 

Red 

4sh 

72 

Light blue 

Red 

49h 

75 

Light green 

Red 

4*h 

7i 

Light cyan 

Red 

4bh 

75 

Light red 

Red 

4Ch 

76 

Light magenta 

Red 

4l»h 

77 

Yell *w 

Red 

4Eh 

7» 

Bright white 

Red 

4 ih 

79 

Black 

Magenta 

*Ph 

80 

Blue 

Magenta 

51 h 

81 

Green 

Magenta 

52h 

82 

Cyan 

Magenta 

5a h 

83 

Red 

Magenta 

j4h 

84 

Magenta 

Magenta 

55h 

85 

Brown 

Magenta 

5<*h 

86 

V."hite 

Magenta 


87 

Gray 

Magenta 

58h 

88 

Light blue 

Magenta 

59h 

89 
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Table 20.3- continued ___ 

Foreground Background Hex Value Decimal Value 


Light green 

Magenta 

Light cymn 

Magenta 

Light red 

Magenta 

Light magenta 

Magenta 

Yellov r 

Magenta 

Bright white 

Magenta 

Black 

Brown 

Blue 

Brown 

Green 

Brown 

Cyan 

Brown 

Red 

Brown 

Magenta 

Brown 

Brown 

Brown 

White 

Brown 

Gray 

Brown 

Light blue 

Brown 

Light green 

Browr. 

Light cyan 

Biown 

Light red 

Brown 

Light magenta 

Brown 

Yellow 

Brown 

Bright white 

Brown 

Black 

White 

Blue 

White 

Green 

White 

Cyan 

White 

Red 

White 

Magenta 

White 

Brown 

White 

Whhe 

Wl*e 

Gray 

White 

UgbtMue 

White 


5Ah 

90 

5Bh 

91 

5Ch 

92 

5Dh 

93 

5Eh 

94 

5Fh 

95 

60h 

96 

6lh 

97 

62h 

98 

63h 

99 

64h 

:oo 

65h 

101 

6jh 

102 

67h 

103 

68h 

104 

69h 

105 

6Ah 

106 

6Bh 

107 

6Ch 

108 

6Dh 

109 

6Eh 

110 

6Fh 

111 

70h 

112 

71h 

113 

72h 

114 

73h 

115 

74h 

116 

75h 

117 

76h 

. 118 

77h 

119 

78h 

120 

79h 

121 
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Foreground 

Background 

Hex Value 

Decimal Value 

Light green 

White 

"Ah 

122 

Light cyan 

White 

7Bh 

123 

Light red 

White 

7Ch 

124 

Light magenta 

White 

7Dh 

125 

Yellow 

White 

7Eh 

126 

Bright white 

White 

Th 

127 


Scroll Window Down (Interrupt lOh, service 7) 

Category: Video services 
Registers on Entry: 

AH: 7 

AL: Number of lines to scroll 

BH: Display attribute for blank lines 

CH: Row for upper left comer of window 

CL: Column for upper left corner of window 

DH: Row for lower right corner of window 

DL: Column for lower right corner of window 

Registers on Return: Unchanged 

Memory Affected: This service modifies the desired video-buffer area of the active 
display page. 

Syntax: 


MOV 

AH,7 

;Specify service 7 

MOV 

AL.5 

;Want to scroll 5 lines 

MOV 

BH,7 

;Normal white-on-black 

MOV 

CH, It 

;Upper left * 10,5 

MOV 

CL,5 


MOV 

0H,2t 

;Lower right * 20,74 

MOV 

DL ,74 


INT 

1th 

;BI0S video interrupt 
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Description: Use this service, whic h is .he opposite of service 10/6. to selectively 
: c “u down portions of the text screen. Only .he currently active text-d.splay page 
is affected. The number of lines .0 scroll, contained in AL, is set for the desired value. 
If this value is set to 0, or to a value greater than the height of the specified window, 
the entire window area is cleared (Using a value 1 greater than the window height 
will clear the window area more quickly than using zero, because the routine loops 
until AL decrements to zero, regardless of its value at entry.) 


CX and DX should contain the upper left and lower right coordinates for the 
window, respectively. The high byte of each register is the row, normally in the range 
ofOto 24. The low byte is the column, normally either 0 to 39 orOto 79. depending 
on the current display mode. If the rectangle specified is inverted so that the value 
in CX is greater than that in DX. the results will be unpredictable. 


The information scrolled oft the bottom of the window is lost, and the blank 
lines scrolled on the top of the wind< >\v c< insist of spaces with the character attribute 
specified by the value in BH. (Some of the possible video attributes are listed in 
table 2C.3.) • 


Read Character and Attribute (Interrupt 10b, service 8) 

Category: Video services 
Registers on Entry: 

AH: 8 

BH: Video page number 

Registers on Return: 

AH: Attribute byte 

AL: ASCII character code 

Memory Affected: None 

Syntax: 


POSITION CURSOR AT 

DESIRED LOCATION PRIOR TO USING THIS SERVICE 

} (SEE SERVICE 10/2) 

■ 

MOV AH,2 

;Specify service 2 

MOV DH.O 

;Place cursor at top left 

MOV DL,0 

; corner of screen (B,B) 

MOV BH ,0 

;Primary text page 

INT I0h 

»BIOS video interrupt 


; NOW USE SERVICE 1S/S TO READ THE CHARACTER/ATTRIBUTE WORD 
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MOV 

AH,8 

.'Specify service 8 

M3V 

BH,0 

;Primary text page 

IKT 

10h 

;BI0S video interrupt 


‘Description: Because this service reads (from any display page) the charactet and 

attribute aj the cursor s current position, you are not limited to the currently visible 
display page.. 

This service works in both text and graphics modes, although the clrwiicter 
attribute has significance only in text mode, in text mode, the value returned in AH 
represents the characters video attribute (refer to table 20.3). In graphics mode, the 
color of the character is returned in AH. NULLL (ASCII 0) is returned in AL if the 
character at the cursor s current position (in graphics mode) does not match any 
valid ASCII character. 


Write Character and Attribute (Interrupt 10h, service 9) 

Category: Video services 
Registers on Entry: 

AH: 9 

AL: ASCII character code 

BH: Video |&e number 

BL- Video attribute of character in AL 

CX: Number of character/attribute words to display 

Registers on Return: Unchanged 

Memory Affected: This service modifies the desired area of the active display page's 
video buffer. 


Syntax: 


MOV 

AH,9 

;Specify service 9 

MOV 

AL,'- 1 

;want to display a dash 

MOV 

BH,0 

;Primary text page 

MOV 

BL,0Eh 

;Yellow on black attributa 

MOV 

CX,50h. 

;Print B0 characters 

INT 

10h 

;BI0S video interrupt 


Description: This service displays a specific number of characters at the cursor’s 
current position on any valid video page. 

The character in AL is displayed with the video attribute specified in BL, which 
is valid only for text modes. (For a list of possible video attributes, refer to table 20.3.) 
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Graphics modes, .he color of thf character (foreground, should be specified ,n 
! . P lf b ? „ 7 of BL is set to 1, then the color tn BL is XORed with the background color 
where the character is to be displayed If the same character (AL, is displayed a. the 
same posmon with the same color (BL, and b.t 7 of BL set. the character will be 
erased and the background will remain undisturbed. 


The character displayed by this service can be displayed on any valid video 
page, not just on the currently visible one. By using this service and service 10/OAh, 
you ca n create a page of text on a background (not displayed) page, and then display 
the entire page at once through service 10/5. 

This service can be used to display any number of characters from 1 through 
65.556. Setting the value in CX to 0 signifies 65,536 characters, the ultimate number 
of character repetitions. In text mode, if the number being displayed extends beyond 
the right margin, the characters progress from line to line. In graphics mode, 
however, no line wrap occurs; only those characters on the current line are 
displayed. 

Even though this service displays a specified number of characters at the 
current cursor position, the cursor position does not advance. To subsequently 
change the cursor position, use service 10/2. 



Write Character (Interrupt 10h> service OAh;- 

Category: Video services 

Registers on Entry : 

AH: OAh 

AL: ASCII character code 

BH: Video page number 

BL: Color of character in AL (in graphics modes only) 

CX: Number of character/attribute words to display 

Registers on Return: Unchanged 

Memory Affected: This service modifies the desired area of the active display page's 
video buffer. 


Syntax: 


MO V 

AH.eArt 

;Specify service BAh 

UOV 

Ai., • • * 

;*ant to display an asterisk 

MOV 

Bn,® 

;Primary teat page 

MOV 

c*,l 

;Print only i character 

IWT 

l®n 

;BI0S video interrupt 
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Description: This service is effectively the same as service 1J0/9, but uses the existing 
video attribute values. In graphics modes, the color of the character (foreground) 
should be specified in BL. If bit 7 of BL is set to 1, the color ir. 3L is XORed with the 
background color where the character will be displayed. If the same character (AL) 
is displayed at the same position with the same color (BL) and bit 7 of BL set, the • 
character will be erased, and the background will remain undisturbed. 

The character can be displayed on any valid video page (not just on the 
currently visible video page). Using this service and service 10/9, you can create a 
page of text on a background (not displayed) page, and then display the entire page 
at once through service 10/5. 

This service can be used to display any number of characters from 1 through 
65,536. Setting the value in CX to 0 signifies 65,536 characters, the ultimate number 
of character repetitions. In text mode, if the number being displayed extends beyond 
the right margin, the characters progress from line to line. In graphics diode, 
however, no line wrap occurs; only the characters on the current line are displayed. 

Even though this service displays a specified number of characters at the 
current cursor position, the cursor position does not advance. To subsequendy 
change the cursor position, use service 10/2. 


Set Color Palette (Interrupt lOh, service OBh) 

Category: Video services 

Registers on Entry: 

AH: OBh 

feH: Palette ID 

BL: Palette ID color value 


Registers on Return: Unchanged 


Memory Affected: None 

Syntax: 

MOV AH,OBh 

MOV BH,1 

MOV BL.O 

INT 10h 


;Specify service OBh 
;Setting palette 
;Oreen/red/brown palette 
;BI0S video interrupt 


Description: lliis service, which is used primarily to set the color palette used by 
medium-resolution graphics services, has significance only in a few- video modes, 
most notably mode 4. (For more information on video modes, see the service 
10/0 description.) 
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This service docs not affect the video memory; it only changes the way the 6845 
CRT Controller chip on the CGA board interprets and displays pixel values already 
in video memory. 

v\ if BH contains 0, the value of BL is used as both the background and border 
colors. If BH contains a 1, the value in BL specifies which color palette to use; BLcan 
be set to any value, but only the contents of the low bit arc significant. This bit valu j 
determines one or the other of the following palettes: 

Value Palette _ 

0 Green, red, and brown 

1 Cyan, magenta, and white 

Notice the colors for palette 0. The technical specifications for the CGA card 
and the 6845 CRT Controller show that these are the proper colors, although the 
system BIOS reference in the IBM Technical Reference manual states that the colors 
for this palette are green, red, and yellow. 

A palette specifics the display colors to be used for various bit combinations. 
Changing the ^alette changes the screen display immediately. Rapidly using this 
service and alternately changing the palette can result in a flashing screen. The pixel 
bit determination is as follows: 


Pixel 

Value 

Palette 

0 Color 

Palette 

1 Color 

00 

Background 

Background 

01 

Green 

Cyan 

10. 

Red 

Magenta 

11 

Brown 

White 


You can use this service also to set the border color in text mode. In text mode, 
if BH is 0, the value in BL is used as the border color. 
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Wfitc i'ixel Dot (Interrupt lOh, service OCh) 

Category: Video services 

Registers on Entry: 

AH: OCh 

AL: Pixel value 

CX: Pixel column 

DX: Raster line (pixel row) 

Registers on Return: Unchanged 

THiS SCrViCe m0d,fitS ' h ' d "' red arca of th ' display 

Syntax: 

;Specify service 0Ch 
;Pixel value to use 
{Position «t 100,160 

{BIOS video interrupt 

Description: This general-purpose graphics plotting service (the opposite of 
serv.ee 10/ODh) works in either medium- or high-resolution graphira rn^les 
although the effects in each are different. ’ 

In medium-resolution graphics modes on the CGA, the contents of AL can 
vary from 0 to 3. The display effect of these pixel values depends on the color palette 
m use (see service 10/OBh). The results of the various settings of AL are 


MOV 

AH ,0Ch 

MOV 

AL,11b 

MOV 

CX,A0h 

MOV 

DX,64h 

I NT 

10h 


Pixel 

Value 

Palette 

0 Color 

Palette 

1 Color 

00 

Background 

Background 

01 

Green 

Cyan 

10 

• 

:i 

Red 

Magenta 

Brown 

White 


% 

In high-resolution graphics modes on the CGA, the value of AL can vary 

etween 0 and 1. These values correspond to whether the pixel is off (black) or on 
(white). 


Scanned by CamScanner 



If Uie high-order bit of AL Is set (1). the pixel color is XORed with the pixel’, 
/ " *r« Because of the behavior of XORJng values, this capability provides 

aquick way todis'play a pixel and then to erase it by again writing the same pixel vahe 
‘o ie location. If the high-order bit of AL is set (0), the ptxel value .s wntten to die 

oixel location. 


The register pair DX:CX contains the pixel’s plotting coordinates. DX Is the 
raster line, or vertical pixel position; its value can range from 0 to 199, or from 0 to 
349 for some EGA video modes. The value of CX (the horizontal pixel position) can 
range either from 0 to 319 (medium-resolution) or from 0 to 639 (high-resolution). 
Coordinates are numbered from top to bottom and from left to right; 0,0 is the top 
left screen comer, and either 199,319 or 199,639 is the bottom right copter, 
depending on the resolution of the video mode. If you specify coordinates outside 
the legal range for the current graphics mode, the results can be unpredictable. 


Read Pixel Dot (Interrupt lOh, service ODh) 

Category: Vided services 

Register.) on Entry: 

AH: ODh 

CX: Pixel Column 

DX: Raster line (pixel row) 

«Legisters on Return: 

AL: Pixel value 

CX: Pixel column 

DX: Raster line (pixel row) 


Memory Affected: None 

Syntax: 

MOV AH,ODh 

MOV CX,A»h 

MOV DX,64h 

INT 10h 


; Specify service SDh 
;W*nt pixel value at 
; coordinate 10#,160 
;BI0S video interrupt 


Description: This service (the opposite of 10A)Ch) is used in either medium* 
high-resolution graphics modes to determine the pixel value of the pixel at an? 
given screen location. 

The desired pixel coordinates are specified in the register pair DX.-CX- DX •* 
the raster line, or vertical pixel position-, its value can range from 0 to 199, or frrim 
0 to 349 for some EGA video modes. The value of CX (the horizontal pixel positfcXV 
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can range either from 0 to 319 (mediumresolution) or from 0 to 639 (high- 
resolution). Notice that this horizontal resolution is in a 164* register but that the 

bottom 0 and f na,e ; S J n “ Coordi " a '« ™ numbered from top to 

bottom and from left to right; 0.0 is the top left screen comer, and either 199.319, 

video mod if ^ * >oltom n 8 ht corner, depending on the resolution of the 

ttr-ohi«ml| lf y i? U $PC . Clfy coordinaics out5idc legal range for the current 
graphics mode, the results oan be unpredictable. 


he pixel value returned in AL depends on the current video mode. In medium- 
reso ution graphics modes on the CGA, the value of AL can vary from 0 to 3. In high- 
rcso ution graphics modes on the CGA, the value of AL can vary between 0 and 1. 
(hor more information about pixel values, see the description for service lO'OCh.) 


TTY Character Output (Interrupt lOh, service OEh) 

Category: Video services 
Registers on Entry: 

AH: OEh 

AL: ASCII character code 

BH: Video page number 

BL: Character color (graphics foreground) 

Registers on Return: Unchanged 

Memory Affected: This service modifies the desired area of the active displav pace’s 
video buffer. Ui ^ 


Syntax: 


MOV AH.SEh 

MOV AL,*.' 

MOV BH.t 

int ion 

;Specify service OEh 
;Output a period 
;Primary video page 
;9I0$ video interrupt 


Description: This service is similar to service 10/9, except that the output is In 
Teletype mode (a limited amount of character processing is performed on the 
output). The ASCII codes for bell (07), backspace (08), linefeed (10), and carriage 
return (13) are all intercepted and translated to the appropriate actions. Line wrap 
* ^^tolling are performed If the printed characters exceed the right display margin 

or the bottom display line. F v 

_ Ptcau sc the ASCII value of the character to be output is loaded in AL, and the 

number Is loaded in BH, this output service can be used for displav pjgo 
other than the current one. By using this service and sen ice 10/OAh, you can crea r . 
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a page of text on a background (not displayed) page, and then display the entire p 3 g 0 
at once through service 10/5. If output is to a background page, the processing of the 
bell character (ASCII 07) will still result in the familiar “beep.” 

The foreground color, which is specified in BL. has significance only j n 
graphics modes. Notice that the syntax example for this service does not specify BL 
in text mode, the current video attributes for the screen location are used. With this 
service, you cannot specify a video attribute other than the current one. 

You can use this service, which advances the cursor position, to display 
multiple characters in series. With this service, you do not have to set the cursor 
position before displaying each character. 


Get Current Video State (Interrupt lOh, service OFh) 

Category: Video services 

Registers on Entry: 

AH: OFh 

Registers on Return: 

AH: Screen width 

AL: Display mode 

BH: Active display page 

Memory Affected: None 

Syntax: 

MOV AH,OFh 

INT 10h 

MOV COLUMNS,AH 

MOV MODE ,AL 

MOV PAGE ,BH 

Description: This service, which is used to determine the computer’s current video 
state returns three pieces of information: the width in columns of the display screen 
(AH), the current video-display mode (AL), and the current video-display page (BH). 

Table 20.1 (service 10/0) lists possible video-mode settings. 


;Specify service OFh 
;BI0S video interrupt 
;Save number of columns 
;Save display mode 
;Save display page 


Scanned by CamScanner 


Chapter 20: Accessing BIOS Services 



EGA/VGA Palette Registers (Interrupt lOh, service lOh) 

category: Video services 

Registers on Entry: 

AH: 10h 

AL: 00h. Set palette register 

BH: Color value 

BL: Palette register to set 

AL: Olh, Set border color register 

BH: Color value 

AL: 02h, Set all registers and border 

DX: Offset address of 17-byte color list 

ES: Segment address of 17-byte color list 

AL: 03h, Toggle blink/intensity (EGA only) 

BL: Blink/Intensity bit 

OOh = Enable intensity 
Olh = Enable blinking 

AL: 07h, Read palette register ( PS/2 only) 

BL: Palette register to read (0-15) 

AL: 08h, Read overscan register (PS/2 only) 

AL: 09h, Read palene registers and border (PS/2 only) 

DX:* Offset address of 17-byte table for values 
ES: Segment address of 17-byte table for values 

AL* 10b, Set individual color register 

BX: Color register to set 

CH: Green value to set 

CL Blue value to set 

DH: Red value to set 

AL 12h, Set block of color registers 

BX: First color register to set 

CX: Number of color registers to set 

DX: Offset address of color values 

ES: Segment address of color values 

AL 13h, Select color page 

BL OOh, Se.ect paging mode 

BH: Paging mode - 

OOh = 4 register blocks of 64 registers 
Olh * 16 register blocks of 16 registers 
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AL: 13H, Select color page 

BL: 01 h. Select page 

BH: Page number 

00-03h = 64 register blocks 
OO-OFh =16 register blocks 

AL: 15h, Read color register ( PS/2 only) 

BX: Color register to read 

AL: 17h, Read blocl. of color registers 

BX: First color register to read 

CX: Number of color registers to read 

DX: Offset address of buffer to hold color values 

ES: Segment address of buffer to hold color values 

AL: lAh, Read color page state 

AL: 1BK, Sum color values to gray shades 

BX: First color register to sum 

CX: N umber of color registers to sum 

Registers on Return: 


Subfunctions 07h-08h 


BH: 

Value read 

Subfunction 

09h * 

DX: 

Offset address of 17-byte table 

ES: 

Segment address of 17-byte table 

Subfunction 

15h 

CH: 

Green value read 

CL. 

Blue value read 

DH: 

Red value read 

Subfunction 

17h 

DX: 

Offset address of color table 

ES: 

Segment address of color table 

Subfunction 

lAh 

BL: 

Current paging mode 

CX: 

Current page 


Memory Affected: Varies by subfunction 


Syntax: Varies by subfunction 

Description: On the MCGA, EGA, and VGA display systems, this function controls 
the correspondence of colors to pitel values. Although listed as reserved in the IBM 
Personal <. omputcr aT BIOS, this function is an extension to the BIOS, applicable 
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ro hCAA GA display system*. Some subfunciions. designated by the 
when call,ng thts function, arc not available on the hS 2 Mode, JO 
include sublunotions Olh. 02n. 07 h . 08h. 0%. 13h. and Uh 


EGA/VGA Character Generator 
(Interrupt lOh, service llh) 

Category: Video services 


ateglsters on Entry: 


AH: 

AL: 

BH: 

BL: 

CX: 

DX: 

BP: 

ES: 

AL: 

BL. 


llh 

00h, User alpha load 
Number of bytes per character 
Block to load 
Count to store 
Character offset into table 
Offset address of user table 
Segment address of user table 

Olh, ROM monochrome set 
Block *o load 


AL: 02h, ROM 8*8 double dot 

BL: Block to load 

AL- 03h, Set block specifier 

BL- Character-generator block selection 

AL: lOh, User alpha load 

BH: Number of bytes per character 

BL Block to load 

CX: Count to store 

DX: Character offset into table 

BP: Offset address of user table 

ES: Segment address of user table 

AL l lh, ROM monochrome set 
BL: Block to load 

AL: 1 2h. ROM 8*8 double dot 

BL Block to load 

AL: 20h, Set user graphics characters pointer at 1 Fh 

Offset address of user table 
Segment address of user table 


contents of AL 
system. These 
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AL. 2 lh, See user graphics characters pointer at 43h 

BL: Row specifier 

CX: Bpcs per character 

BP: Offset address of user table 

ES: Segment address of user table 

AL: 22 h, ROM 8*14 set 

BL: Row specifier 

AL: 23h, ROM 8*8 double dot 

BL: Row specifier 

AL: 30h, System information 

BH: Font pointer 

Registers on Return: Varies by subfunction 
Memory Affected: Varies by subfunction 
Syntax: Varies by subfunction 

Description: This service, which contains 14 subfunctions, supports the character- 
generator functions * f *he EGA, MCGA. and VGA, enabling a program to set up its 
own character-generator tables. The service also makes changing the number of 
rows displayed easy to do. Some subfunctions, designated by the contents of AL 
when this service is called, are not available on the PS/2 Model 30 system. These 
include subfunctions Olh. lOh, llh, 12h, and 22h. 

Subfunctions 11 h, 12h,and l4h are particularly useful because they reprogram 

the CRT controller to display more than 25 rows of text. The exact number displayr ' 
varies between EGA and VGA; for a VGA, the number depends on how many sc~ i 
lines were chosen (service 10/12). 


Alternate Video Select (Interrupt lOh, service 12h) 

Category: Video services 
Registers on Entry: 

AH: 12h 

BL: lOh. Return EGA information 

BL: 20h, Select alternate print-screen routine 

BL: 30h, Select number of scan lines 

AL: OOh — 200 lines 

Olh = 350 lines 
()2h = -*t>0 lines 
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Dl.: 31h, Load palette when setting mode 

AL: 00h = enable 

Olh = disable 

BL: 32h, Video on/off 

AL: OOh = enable 

Olh = disable 

BL: 33h, Sum color to gray scale 

AL: OOh = enable 

Olh = disable 

BL: 34h, Cursor emulation on/off 

AL: OOh = enable 

Olh = disable 

Registers on Return: 

Subfunction lOh (setting in BL): 

BH: BIOS video mode (0 color/1 mono) 

BL: Size of EGA RAM (0=64K to 3«256K) 

In all cases, AL = 12h if service was valid. 

Memory Affected: None 

Syntax: 

MOV AX,1202h ;Service 10/12, set 400 scan lines 

MOV BL,30h ' 

INT I0h ;BI0S video services interrupt 

Description: This service and its various subfunctions are effective only for the EGA, 
MCGA, and VGA adapters. 


Write String (Interrupt lOh, service 13h) 

Category: Video services 

Registers on Entry: 

AH: 13h 

AL: Mode 

BH: Video page number 

BL: Character attribute (depending on AL) 

CX: Length of string 

DH: Cursor row where string is to be displayed 

DL: Cursor column where string is to be displayed 
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»p: Offset address of string 

ES: Segment address of string 

Registers on Return: Unchanged 

Memory Affected: This service modifies the desired area of the active display page s 
video buffer. 

Syntax: 


MOV 

BH,0 

;Primary video page 

MOV 

0L,07h 

;Normal attributes 

MOV 

OH,5 

;Display string at 

MOV 

DL, 5 

; coordinates 5,5 

PUSH 

DS 

;Make ES same as OS 

POP 

ES 


MOV 

BP,OFFSET ES:MSG_1 

{Point to message offset 

MOV 

CX.lOh 

{Standard string length 

MOV 

AH,l3h 

{Specify service 13h 

• INT 

10h 

{BIOS video interrupt 


Description: This service is available only on PC XTiwitb BIOS dates of 1110186 or 
later, on the Personal Computer AT, and on machines in the PS/2 family. Use this 
service, which is a logical extension of the BIOS character-display functions, to 
display an entire string on any video page. 

The mode specified in AL determines how BIOS will treat the string to be 
displayed. Table 20.4 lists this service's four modes. 


Table 20.4. Modes for service 10 / 13 ■ 

Mode 

Cursor 

Attribute 

String Composition 
(C=character, A-attribute) 


0 

Not moved 

In BL 

CCCCCCCC...CC 


1 

Moved 

In BL 

CCCCCCCC...CC 


2 

Not moved 

In string 

CACACACA . CA 


3 

Moved 

In string 

CACACACA. CA 
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Nonce that the display attributes can he- .specilied either in HI. or in the siring 
depending on the contents of AL. If you are using mode 2 or 5. the contents of HI. 

are not sigmlicunt I he mode also determines whether the cursor is moved when the 
string is displayed. 

... TheS,r ! n8 1 S address is reified in F.S:BP. CX contains the length of the string 

d,splays lh * slnn B until CX reaches 0. Do not use a length ofO. If vou do. 

rha«^ harM K l ,^ diSplayCd - and lhc cffccls of displaying this number of 
characters probably will be undesirable. 

Because this service makes limited use of BIOS service 10/0E. some character 

/nr^'l 8 ,S pcrformcd on lhc individual siring characters. The ASCII codes for bell 
(07), backspace (08), linefeed (10). and carriage return (13) are all intercepted and 
irected to service 10/0E, where they are translated to the appropriate actions. Line 
wrap and scrolling are performed if the printed characters exceed the right display 
margin or the bottom display line. If the string character is not a bell, backspace, 
linefeed, or carriage return, it is displayed by service 10/9. 

Although this service is neither particularly fast nor efficient, it is convenient, 
he routines in Chapter 1*>. 'Video Memory." result in faster displays but entail more 
work for the programmer. Only you can decide which to use. 


Get Equipment Status (Interrupt llh) 

Category: System services 
Registers on Entry: Not significant 
Registers on Return: 

AX: Equipment status 

Memory Affected: None 
Syntax: 

llh ;Invoke BIOS interrjpt 

Description: Use this rudimentary service, which returns a minimal amount of 
information, to determine what equipment is attached to »he computer l he 
equipment status word is set up during the booting process and doc* not change. 
The meaning of each bit in the returned word is shown in table 20.5. 
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Table 20.5. 

Hit meanings for equipment stt,tu< word returned by interrupt JI. 

Hits v 

FEDCBA98 

76543210 

Meaning of Hits 

XX 


Number of printers attached 

X 


Not used 

e 


Cianic adapter not installed 

1 


Ciante adapter installed 

XXX 


Number of serial cards attached 

X 


Not used 


00 

1 disk drive attached (if bit 0 - 1 ) 


01 

2 disk drives attached (if bit 0 = 1 ) 


10 

3 disk drives attached (if bit 0 = 1 ) 


11 

•i disk drives attached (if bi' 0 = 1 ) 


01 

lnitir.1 video mode— 40 x 25 UVC/color card 


10 

Initial video mode—HO x 25 B\X',color card 

• 

11 

Initial video mode—80 x 2 ^ BW - mono card 


00 

16k system board RAM 


01 

32K system board RAM 

* 

10 

**HK system board RAM 


11 

64 k system board RAM 


1 

Math coprocessor installed 


0 

No disk drives installed (bits 6-7 insignificant) 


1 

Disk drives installed (bits 6-7 significant) 


Depending on (he computer you are using, certain portions of this equipment 

status word may not be significant. If you are using an IBM Personal Computer ATt 

for example, the value of hits 2 and 3 have no meaning. These bits are relics of the 

days when 64 K of RAM was considered as much as anyone could possibly want in a 

microcomputer. 

• 

You can see that the register contents on entry are not significant and that AX 
is the only register changed on return. 


Scanned by CamScanner 



luptcr 20 Accessing UK)S Senium 


507 


(>i i Mcmor>' Size (Interrupt 12h) 

( ategnry: System services 
Registers on Entry: Not significant 
Registers on Return: 

AX: Memory blocks 

Memory* Affected: None 
Syntax: 

INT I2h ;Invoke BIOS interrupt 

Description: Use this service to return the number of contiguous IK blocks of 
memory installed in the computer. The memory* size, which is determined when you 
power-up the computer, is returned in AX. 

Notice that the number pf contiguous memory* blocks is returned. If the power- 
on self test (POST) determines that defective RAM chips arc installed in the 
computer, the value returned by this interrupt will be equal to the number of IK 
blocks counted before the defective memory area was encountered. 

On entry of this interrupt, the register contents are not significant. AX is the 
only register changed on return. 

The method used to determine available memory depends on the system, but 
usually consists of an attempt to read and write to a memory block. As soon as the 
write/read cycle fails, the end of memory is assumed to have been reached. 

) * 

When there is more than 640K of memory, service 15U8 must be called to 
determine extended-memory size. 

On PS/2 systems, this interrupt returns a maximum amount of memory of up 
to 640K, minus the amount of memory set aside for the extended BIOS data area 
(EBDA). The EBDA may be as little as IK. (See service 15/Cl for more information.) 


Reset Disk Drives (Interrupt 13h, service 0) 

Category: Disk services 
Registers on Entry: 

AH: 0 

Di.: Drive number (0 based) • 

bit 7 s 0 for a diskette 
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Register* on Return: l m lunged 
Memtny Affected: None 


Syntax: 

MOV AH, 0 

MOV Dt,82h 

TNT I3h 


;Specify service 0 
;for drive C 
; BIOS disk interrupt 


Description: Use this service to *eset the disk drive controller. (The service works 
on the NEC series of floppy disk drive controllers that IBM specifies as standard 
equipment: in most implementations, it performs the same function for any hard 
disk drive controllers present.) 


Calling this service has no apparent effect on the disk drives. The recalibrate 
command is sent directly to the floppy drive controller in use, and a reset flag is set 
to recalibrate all the drives the next time they are used. This recalibration retracts the 
rcad/u rite head to track 0. causing the familiar “grinding" sound often heard after 
a disk error. The readAvrite head is forced to track 0 and then must seek our the 


desired track. 


I’sed primarily in routines that handle critical errors on disks, this service 
forces the controller to recalibrate itself on the subsequent operation. If a critical 
error occurs, the sc a ice is necessary for reliable disk operation; it forces the disk 
controller to make no assumptions about its position or condition—assumptions 
that inav he wrong because of the critical*error condition. 


Gel I loppy Disk Status (Interrupt 13h, service 1) 

Category: l)isk services 
Register* on Entry: 

All. I 

Dl. Drive number (0 based) 

bit " = 0 for a diskette 

Registers on Return: 

AH: Status byte 

Memory Affected: None 
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MOV 

MOV 

1NT 


AH, 1 
DL, 82h 
13h 


;Specify service 1 
;for drive C 
•BIOS disk interrupt 


Which wh^ilk o^ $ i tht MaiUS ? lhC d,Sk dnve conlf ollcr. The status. 

is returned in AH. The meanincof e?"h h— *u rcad,nB ‘ wnl 'ng. or formatting), 
tabic 20 6. n ‘" R ° f c,<:h b1 ' ,n «>c returned status byte is shown in 

— 20 6 - Meani ”e o/the s, alu! byte relumed /■■■ , a,/ 

n.’i. ^— _ 


Bits 
76M321# 

1 


Hex Decimal 


80 

40 

20 

10 

9 

8 


11 


128 

64 

32 

16 

9 

8 

4 

3 


Meanin g of Bits 

Time out—drive did not respond 

Seek failure—couldn’t move to 
requested track 

Controller malfunction 
Bad CRC detected on disk read 
DMA error—64K boundary crossed 
DMA overrun 

Bad sector/scctor not found 
Write protect error 
Bad sector ID (address) mark 
Bad command 


Read Disk Sectors (Interrupt 13h, service 2) 

Category: Disk services 


Registers on Entry: 


AH: 

AL: 

EX: 

CH: 

CL: 


2 

Number of sectors 

Offset address of data buffer 

Track 

Sector 
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DU Head (MileI number 

Dl I >rnc number 

I V Sc gme nt address , ,f data buffer 

Rc|>islcP) on Return: 

AH: Return code 

Memory Affected: RAM buller area s | 
overwritten b> sectors requested from disk. 


•a specified by address starting at I-.S.UX -s 


Syntax: 

wo v 
uov 

MOV 

UOV 

uov 

FUjH 
POP 

liov 
*JQ\ 

IV 


AL, 1 

CH,TRACK 
CL, SECTOR 
DH.SIOE 
CL.DRIVE 
DS 
ES 

BX,OFFSET ES:BUFFER 

A- .2 

i3h 


•.Pending 1 sector 
-.Specify track 

; end sector 

;Specify s:de 
:Soecify o r : e 
;Point ES tc proper 
; sefpc ** address 
:Of*Sv‘t of ouffer area 
:Soeciry service 2 
:BIOS disk interrupt 


Description: l sc this service to control reading from the disk. This service is the 
opposite <»f sen-ice 13 3- which controls writing to the disk 

To use this service, you must specify the precise physical location on the disk 
at v. h.ch \ou want to begin reading The drive is specified in Dl. (A*0. B-1. C-’2, 
ct. <>r bit " is set if the drive is a hard disk) The vide, or head, is specified in DH .nd 
t m u . o or 1 CH and CL contain the track and sector, respectively. These values will 
van depending on the rype of disk drive in use. The number of sectors to be read 

i*% specified m AL. 

The final registers to be set up specify which RAM area will be used as a buffer 
lor the sectors that are read This address is specified in ES;BX. You need to know 
the s./e of each disk sector ahead of time because this information determines how 
I irge the RAM buffer should be For instance, if each disk sector contains S12 bytes, 
and ye >u are going to read 4 sectors, the length of your buffer should be 2K. or 2.048 

by ics 

This service checks parameters only on the requested drive number (DL): all 
otht r mussed parameters are not checked for validity'. If you pass invalid parameters, 
(he r. suits are* unpredictable. Table 20.7 shows some ty pical parameter ranges for 
fins H*n »cc 
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luhtc .O * 

rnn\f\ /•»» 

t hj using ,i UtOK disk. 

l‘*irtinn.‘lcr 

Kiyislcr 

\\ilnl Ktinyc 

* ol M\ior> 

Al 

1 through V 

Track 

ill 

0 through 5»,» 

Sector 

Cl 

1 through 9 

Mead (side) 

Dll 

Oor 1 

Drive 

Dl. 

0=A. 1=1). 2 = e. etc 


n M - r 'icc. the carry flag signifies whether an error occurred. 

» e cam flag is not set. AH will contain a zero <(») II the earn flag is set. AH will 
contain the disk-status byie described tmder service 15 1 (reler to table 20 6). If an 
error incurs during reading. use scmcc 15 >* to reset the disk system before vou 
attempt another read 

Note: In this serv ice and service 15 3. a particularly confusing error may occur. 
DMA t>our»cary error i«h ?i means that an illegal boundary was crowed when the 
information was placed into RAM Direct Memory Access (DMA) is used by the disk- 
scmcc routines to place inlormation into RAM If a memorv offset address ending 
,n lh, vc (HS: lt)()0. H.SJOOU. ES:AUUO. etc.) falls in the middle of the area being 
overlaid by a sector, this error will occur. You must calculate and read a much smaller 
chunk so that this type of memory boundary' corresponds with a sector boundary. 
I don t know why this happens; it simply is frustrating as heck to a programmer. 


Write Disk Sectors (Interrupt 13h, service 3) 

Category: Disk services 
Registers on Entry*: 

AH: 3 

Al.: Number of sectors 

BX: Offset address of data buffer 

CH: Track 

CL Sector 

DH: Head (side) number 

DL Drive number 

ES: Segment address of data buffer 


511 
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H C |(isic^ on Return: 


All: Return code 


Mentor)' Affected: None 


Syntax: 


MOV 

MOV 

MOV 

MOV 

MOV 

PUSH 

POP 

MOV 

MOV 

INT 


AL ,9 

CH,TRACK 
CL,SECTOR 
DH.SIDE 
OL,DRIVE 
DS 
ES 

BX .OFFSET E9:BUFFER 

AH,3 

13h 


;Write entire track 
;Specify track 
; and sector 
;Specify side 
{Specify drive 
;Point ES to proper 
; segment address 
{Offset of Duffer area 
{Specify service 3 
;BI0S disk interrupt 


Description: This service, which controls writing to the disk, is the opposite of 
service 13/2, which controls reading from the disk 


To use this service, you must specify (in ES:BX) which RAM area will be used 
as the buffer for the sectors written. This buffer area must contain all the information 
you want written to the disk. You must know the size of the sectors being written on 
the disk because this service calculates, based on the sector size and the number of 
sectors to write (AH), the amount of RAM to read and subsequently write. The 
preccdingcxample requires a buffer of 4.068 bytes (4.5K). assuming that each sector 
requires 512 bytes. 

Bv setting up the other registers, you determine the precise physical location 
on the disk at which you wish to begin writing. The drive is specified in DL (A=0, 
g-1. c = 2, etc., or bit 7 is set if the drive is a hard disk). The side, or head, is specified 
in DH. which can be 0 or 1. CH and CL contain the track and sector, respectively. 
(These values will vary, depending on the type of disk drive in use.) In AL, specify 
the number of sectors to be written. 

This service checks parameters only on the requested drive number (DL); all 
other passed parameters are not checked for validity. If you pass invalid parameters, 
the results are unpredictable and may result in errors or damaged disks. (Some 
typical parameter ranges for this service are listed in table 20.7.) 


On return from this service, the carry flag signifies whether an error occurred. 
If the carry flag is not set, AH contains a zero (0). If the carry flag is set, AH contains 
the disk status byte as detailed in service 13/1 (refer to table 20.6). If an error occurs 
during the writing operation, use service 13/0 to reset the disk system before you 
attempt another write operation. 
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ote. ni tis s». r\ k eaiul service 13 2. a p.iniculurly contusing error max iniur 
OMA boundary error t*H y> means that an illegal boundary was crossed vvhen the 
mfor»"i»;on was placed into RAM Direct Memory Access (DMA) is used hv the disk- 
service routines to place inform anon into RAM This error will occur if a memoir 
offset address ending in three zeros ( i;s 1000. i:S 200(). HS 3000. etc ) is crossed 
c ore t is service completes reading an entire sector of information. You must 

t a cu ate an reread so that this rype of mentor)' boundary corresponds with a sector 
boundary. * 


Verify Disk Sectors (Interrupt 13h, service 4) 

Category: Disk services 

Registers oo Entry: 


AH. 

4 


AL. 

Number of sectors 


CH: 

Track 


CL: 

Sec»or 


DH: 

Head (side) number 


DL: 

Drive number 


Registers on Return: 


AH: 

Return code 


Memory Affected: None 


Syntax: 

MOV 

AL,9 

;Venfy entire track 

MOV 

CH,TRACK 

;Specify track 

MOV 

CL,SECTOR 

; and sector 

MOV 

DH.SIDE 

;Specify side 

MOV 

DL,DRIVE 

{Specify drive 

MOV 

AH,4 

{Specify service 4 

INT 

13ft 

{BIOS disk interrupt 


Description: Use this service to verify the address fields of the specified disk sectors. 
No data is transferred to or from the disk during this operation. Disk verification, 
which takes place on the disk, does not (as some people believe) involve verification 
of the data on the disk against the data in memory. Notice that this function has no 
buffer specification. This function does not read or write a disk; rather, it causes the 
system to read the data in the designated sector or sectors and to check its computed 
cyclic redundancy- check (CRC) against data stored on the disk. 
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The CKC is a sophisticated checksum that de tects a high percentage »w .»•»> 
errors that may occur When a sector is written tocltsk. an original UR im ah u'..* ; .| 
and written along with the sector data. The verification service reads the sector 
recalculates the CRC. and compares the recalculated UK 2 with the original UK. it 
they agree, there is a high probability that the data is correct, il they disagree, an erroj 
condition is generated. 

You set up the registers to determine the precise physical location on the disk 
at which you wish to begin verification. The drive is specified in DL(A=(). H= 1,02, 
etc.). The side, or head, is specified in DH and can be 0 or 1. CM and Cl. contain the 
track and sector, respectively. These values will van-, depending on the type of disk 
drive in use. Specify in AL the number of sectors to be verified. 

This service checks parameters only on the requested dmc number i Dl.). all 
other passed parameters are not checked for validity If you pass invalid parameters, 
the results are unpredictable and may result in errors or damaged disks. ( For some 
ty pical parameter ranges for this service, refer to table 20." ) 

On return from this service, the earn' flag signifies whether an error < »i curred. 
If the carry flag is not set, AH contains a zero (0) If the earn flag is set. AH contains 
the disk-status bits as detailed in sen-ice 13/1 (refer to table 2o 6) If an error occurs 
during the w riting operation, use sen ice 13 «» to reset the disk system before 
attempting another read, write, or verify operation. 


Format Disk Track (Interrupt 13h, service 5) 

Category: Disk services 
Registers on Entry: 

AH: 5 

BX: Offset address of track address fields 

CH: Track 

DH: Head (side) number 

DL: Drive number 

ES: Segment address of track address fields 

Registers on Return: 

AH Return code 

Memory Affected: None 
Syntax: 

MOV CH,TRACK ;Specify track 

MOV DH.SIDE ;Specify side 
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MOV 
PUSH 
POP 
MO s' 
MOV 
I NT 


Di.TRIVE 

OS 

ES 

E> Of SE' 



ES fIEi.0 


‘.Specify dr A ve 
Point ES to proper 
segment address 
,Cf*sof of address fields 
.Specify service 5 
:B1 OS disk interrupt 


Description: sc tins serv ice t > lorm.tt a specific track on a disk. To format an entire 
disk, you musi ‘ step through each track, invoking this sen-ice for each track. 

l or more detailed information on the use of this service, refer to Chapter 19. 


Format Cylinder and Set Bad Sector Flags 
(Interrupt 13h, service 6) 

Category: Disk services 


Registers on Entry: 

AH: 6 

Al: Interleave value 

CH: Cylinder (track) number 

DH: Head (side) number 

DL Drive number 

Registers on Return: 

AH: Return code 


Memory Affected: None 
Syntax: 


MOV 

AL, 1 

;i to 1 interleave 

MOV 

CH,TRACK 

;Specify track 

MOV 

DH.SIDE 

;Specify side 

MOV 

DL,DRIVE 

;Specify drive 

MOV 

AH, 6 

;Specify service 6 

INT 

13h 

;BIOS disk interrupt 


Description: When hard disks were introduced for use with the XT and AT 
computer families, this BIOS service was added to allow formatting of a single track 
(cylinder) of a hard disk. The value loaded in DL indicates the disk drive to format. 
This should be a zero-based number, with the high bit ( bit 7 ) set; thus, the first fixed 
disk is indicated as 80h, the second as 81h. 
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On return from this sen ice. the carry ftag signifies whether an error occurred. 
II thi earn Hag is not set. AH contains a zero (0). If the cany flag is set. All contains 
the <l,sk Matus bits as detailed in sen ice 13 1 (refer to table 20.6) 


Format Drive from Specified Cylinder 
(Interrupt 13h, service 7) 

Category: Disk services 
Registers on Entry: 

Ait: 

AL: Interleave value 

CH. Cylinder (track) number 

DL: Drive number 

Registers on Return: 

AH Return code 

Memory Affected: None 

Syntax: 

MOV AL,1 

MOV CH,TRACK 

MOV DL,DRIVE 

MOV AH , 7 

INT I3h 

Description: VThen hard disks were introduced for use with the XT and AT 
computer families, this BIOS service was added to allow formatting of the entire 
fixed disk, beginning with the cylinder (track) indicated in CH. The value loaded in 
DL indicates the disk drive to format. This should be a zero-based number, with the 
high bit (bit 7) set; thus, the first fixed disk is indicated as 80h, the second as 81h. 

On return from this service, the carry' flag signifies whether an error occurred. 
If the carry flag is not set, AH contains a zero (0). If the carry flag is set. AH contains 
the disk siaius bits as detailed in service 13/1 (refer to table 20.6). 


;1 to 1 interleave 
;Specify track 
;Specify drive 
;Specify service 7 
;BI0S disk interrupt 
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Return Drive Parameters (Interrupt 13h. service 8) 

Category*: Disk services 


Registers on Entry: 
AH: 8 


DL: Drive number (0 based) 

bit 7 is set if fixed disk 

Registers on Return: 


CH: 

CL. 

DH: 

DL: 


Number of tracks side 
Number of sectors, track 
Number of sides 

Number of consecutive drives attached 


Memory Affected: None 


Syntax: 


;Use first naro disk drive 
{Specify service 6 
;BJ0S disk interrupt 

Description: Use this service to retrieve disk parameters for a disk drive ( Tins 
service is available only on the IBM Personal Computer AT and PS/2.) 

Notice that when you call this service, you will specify the disk drive number 
in DL (80h for the first fixed disk. 81h for the second, etc.). These numbers do not 
correspond to the standard BIOS disk-numbering scheme. If you attempt the service 

with any out-of-range/ixerf disk drive numbers (those below 80h), an error will be 
returned. 

On return from this service, the carry flag signifies whether an error occurred 
If the cany flag is not set. AH contains a zero (0). If the carry flag is set, AH contains 
the disk-status bits as detailed in service 13/1 (refer to table 20.6). 


MOV DL,80h 
MOV AH,8 

INT 13h 



Initialize Fixed Disk Table (Interrupt 13h, service 9) 

Category: Disk services 
Registers on Entry: 

AH: 9 

DL: Fixed disk drive number 
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Registers on Return: I iulun.m il 
Memnn Affected: None 


Syntax: 


DL, 80 n 
AH, 9 


»*v. •• 9 

;BIOS <J1S* irterrupt 


Description: 1 sc .his sets ice ... i.s.t.al.xc .he five.1 <hsk parame.er ... hies lor a 
spec ifu drice. t This sen in- is orwl'ihtc «.»/...// the HIM rcrsa.„,l<»m,mnrA r.wJ 
/>s J ami trork’S only uithfixaf disks > 

Notice that when vou call this service, you will specify the fixed disk drive 
number in DL (S«h lor the first fixed disk SI h for the second, etc. > I hese numbers 
do n< »t correspond to the standard BIOS disk-numbering scheme. It you attempt the 
scrv.ee with any out-of-range fixed disk drive numbers (those below HOh). an error 

will be returned. 

On return from this sen ice. the earn Hag signifies whether an error occurred. 
If the earn flag is not ..ft. Al I contains a zero ((»). If the earn fiat* is set. Al I contains 
the disk-status byte as detailed in service 13 1 (refer to table 20.6). 

The fixed disk parameter tables for as many as two fixed disks are contained in 
RAM at the memory addresses pointed to by interrupt vectors -»1h and -»6h. 


Read Long Sectors (Interrupt 13h, service OAh) 

Category: Disk sendees 
Registers on Entry: 

AH: OAh 

AL: Number of sectors 

BX: Offset address of data buffer 

CH: Track 

CL: Sector 

DH: Head (side) number 

DL: Fixed disk drive number 

£ 5 : Segment address of data buffer 

Registers on Return: 

AH: Return code 
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Mi nior\ Affected: HAM data buffer Martini; at memory address I’.SIIX is overwritten 
In m i tors requested Irom the fixed disk 


Syntax: 

MOV Al,1 

{Reading i sector 

MOV 

CH,10W_TRACK 

{Specify low-order track 

MOV 

CL.HIGH_TRACK 

{Specify high-order trick 

MOV 

BL,6 

{Want to shift 6 bits 

SHI 

CL.BL 

; left, place in bits 6/7 

OR 

CL,SECTOR 

{Place sector in bits 0-5 

MOV 

OH,SIDE 

{Specify side 

MOV 

Dl,8«h 

{Use first disk drive 

PUSH 

DS 

{Point ES to proper 

POP 

ES 

; segment address 

MOV 

BX,OFFSET ES:BUFFER 

{Offset of buffer area 

MOV 

AH.BAh 

{Specify service ®Ah 

INT 

13h 

{BIOS disk interrupt 


Description: Use this service to control reading long sectors from the IBM Personal 
Computer AT's 20M fixed disk drive. (This service, which is available only on the 
IBM Personal Computer AT and works only with fixed disks . is the opposite of 
service 13 OB. which controls writing long sectors to the fixed disk.) A long sector 
consists of a regular sector of data and four bytes of error-correction information 
used to verify' the information read from the fixed disk. 

To use this service, you must specify the precise physical location on the fixed 
disk at which you want to begin reading. In DL, specify the fixed disk drive number 
(80h for the first fixed disk, 81h for the second, etc.). These numbers do not 
correspond to the standard BIOS disk-numbering scheme. If you attempt the service 
with any out-of-range fixed disk drive numbers (those below 80h). an error will be ■ 
returned. 

In DH. specify’ the side, or head, which may vary from 0 to 15. CH and CL 
contain the track and sector, respectively. These values, which will vary depending 
on what size fixed disk is used, are normally in the range specified in table 20.8. Track 
(Cll) and sector (CL) information in the table arc encoded according to the 
description for this service. 
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Part IV Reference 

— 





Tabic JO A’. Parameter ranges for 
C.om/mter A1 

"service l.i A •>" on MM /Vm»w/ 

Parameter 

Register 

Valid Range 

# of sectors 

Al. 

1-121 

Track 

CH/CL 

0-1023 

Sector 

CL 

i-r 

Head (side) 

Dll 

0-15 

Drive 

DL 

80=first. 81 - second, etc. 


A- vou ran see. (he track range (CM ) can be greater than 255. ihe largest 
number that can be contained in a single byte. Actually, the track is^specificrdu* 
10-bit number, with the two high-order bits stored in bits and 6 of CL. 1 he sector 
specification is stored in bits 0 through 5 of CL. 

The final registers to be set up specify which RAM area will he used as a buffer 
for the sectors that are read This address « specified in EStBX. To derermine the 
si/e of the RAM buffer, vou must know ahead of time how large each disk sector s. 
For instance, if each disk sector contains 512 bytes, and you are going to read four 
sectors. >our buffer should be 2.0-iH bytes <2K) long. 

This service checks parameters on the requested drive number (Dl.) only; all 
other passed parameters are not checked for validity. Ifyou pass invalid parameters, 
the results are unpredictable. 

On rcium from ibis sect ice. the carry flag signifies whether an error occurred. 
If the carry Hag is not set. AH will contain a aero (0). If the carry flag is set. AH will 
contain the disk-status bus as detailed in service 13,1 (refer to table 20.6). If an error 
occurs during the reading operation, use service 130. with the fixed disk drive 
number in DL. to reset the fixed disk system before you attempt another read 

operation. 

Note: In this serv ice, a particularly confusing error may occur DMA boundary 
error ( ah=9 ) means that an illegal boundary was crossed when the information was 
placed inio RAM Direct Memory Access (DMA) is used by the disk-service routines 
to place information into RAM This error will occur if a memory offset address 
ending m three zeros (ES I000. ES 2000. ES 3000. etc ) falls in the middle of the 
area being overlaid bv a sector. You must calculate and reread so that this type of 
memory boundan corresponds with a sector boundary I don't know why this 
happens, but it is frustrating as all get out to a programmer (This crror-cocic 
consideration also applies to serv ices 13 2. 13 3. and 13ABH.) 
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Write Long Sectors (Interrupt 13h, service OBh) 

Category: Disk services 

Registers on Entry: 

AH: OBh 

AL: Number of sectors 

BX: Offset address of data buffer 

CH: Track 

CL: Sector 

DH: Head (side) number 

DL: Fixed disk drive number 

ES: Segment address of data buffer 

Registers on Return: 

AH: Return code 

Memory Affected: None 

Syntax: 

MOV AL, 17 

MOV CH,LOWTRACK 

MOV CL,HIGH_TRACK 

MOV BL.6 

SHL CL.BL 

OR CL,SECTOR 

MOV DH,SIDE 

MOV DL,80h 

PUSH DS 

POP ES 

MOV BX,OFFSET ES:BUFFER 

MOV AH.BBh 

INT 13h 

Description: This service, which controls writing long sectors to the IBM Personal 
' Computer AT 20M fixed disk drive, is available only on the IBM Personal Computer 
AT and works only with fixed disks. (It is the opposite of service 13'0Ah. which 
controls reading long sectors from the fixed disk.) A long sector consists of a regular 
sector of data and four bytes of error-correction information, which is used to verify 
the information read from the fixed disk. 

To use this service, you must specify (in ES BX) which RAM area is used as the 
buffer for the sectors written. The area should be initialized with the desired data in 
the right amount. Because this service calculates the amount of RAM to read and su 
sequently write, based on the number of sectors to write (AH) and the sector size, 


Writing entire track 
Specify low-order track 
Specify high-order track 
want to shift 6 bits 
left, place in bits 6/7 
Place sector in bits 0-5 
Specify side 
Use first disk drive 
Point ES to proper 
segment address 
Offset of buffer area 
Specify service 0Bh 
BIOS disk interrupt 
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von musi know the size of the sectors being written on the disk. Assuming that each 
«ctor requires 512 bytes, the example shown in the syntax section requires a buffer 

of 8,704 bytes (8.5K). 

You set up other registers to determine the precise physical location on the 
fixed disk at which you wish to begin writing. Specify the fixed disk drive number in 
DL (80h for the first fixed disk, 81 h for the second, etc,). These numbers do not 
correspond to the standard BIOS disk-numbering scheme. If you attempt the sen-ice 
with any out-of-range fixed disk drive numbers (those below 80h), an error will be 

returned. 

The side, or head, is specified in DH and may vary- from 0 to 15. CH and CL 
contain the track and sector, respectively. These values, which will vary-depending 
on the size of fixed disk used, are normally in the range specified in table 20.8 (refer 
to sen-ice 13/0Ah). 


The track range (CH) can be greater than 255, the largest number that can be 
contained in a single byte. Actually, the track is specified as a 10-bit number, with the 
tw o high-order bits stored in bits 7 and 6 of CL. The sector specification is stored in 
bits 0 through 5 of CL. 

This service checks parameters on the requested drive number (DL) only; all 
other passed parameters are not checked for validity-. If you pass invalid parameters, 
the results are unpredictable. 

On return from this service, the cany flag signifies whether an error occurred. 
If the carry flag is not set, AH contains a zero (0). If the carry flag is set, AH contains 
the disk-status bits as detailed in service 13/1 (refer to table 20.6). If an error occurs 
during the reading operation, use service 13/0, with the fixed disk drive number in 
DL, to reset the fixed disk system before you attempt another write operation. 

Note: In this service (and services 13/2* 13/3, and 13/0Ah) a particularly 
confusing error may occur. DMA boundary error (AH=9) means that an illegal 
boundary w-as crossed as the information w-as read from the RAM buffer. Direct 
Memory Access (DMA) is used by the disk service routines to place information into 

This error will occur if a memory-offset address ending in three zeros (ES: 1000, 
ES.-2000, ES:3000, etc.) is crossed before this service completes reading an entire 
sector of information. You must calculate and reread so that this type of memory 
boundary corresponds with a sector boundary. 
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Seek Cylinder (Interrupt 13h, service OCh) 

Category: Disk services 
Registers on Entry: 

AH: OCh 

CH: Low-order track 

CL: High-order track 

DH: Head (side) number 

DL: Fixed disk drive number 

Registers on Return: 

AH. Return code 

Memory Affected: None 

Syntax: 


uov 

CH,L0W_TRACK 

;Specify low-order track 

MOV 

CL,HIGH_TRACK 

;Specify high-order track 

MOV 

BL, 6 

;Want to shift 6 bits 

SHL 

CL.BL 

; left, place in bits 6/7 

MOV 

OH,SIDE 

;Specify side 

MOV 

DL,80h 

;Use first disk drive 

MOV 

AH,0Ch 

;Specify service 0Ch 

INT 

13h 

;B10S disk interrupt 


Description: Use this service to move the read/write heads of the fixed disk drive 
to a specific track (cylinder). This service is available only on tbe IBM Personal 
Computer AT and works only with fixed disks. 

To use this service, you must specify the fixed disk drive number (80h for the 
first fixed disk, 81h for the second, etc.) in DL These numbers do not correspond 
to the standard BIOS disk numbering scheme. If you anempt the service with any 
out-of-range fixed disk drive numbers (those below 80h), an error will be returned. 

The side, or head, is specified in DH and may vary from 0 to 15. CH and CL 
contain the track and sector, respectively. These values, which will vary depending 
on the size of fixed disk used, are normally in the range specified in table 20.8 (refer 
to service 13/OAh). 

The track range (CH) can be greater than 255, the largest number that can be 
contained in a single byte. Actually, the track is specified as a 10-bit number, with the 
two high-order bits stored in bits 7 and 6 of CL 
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This service chc< ks parameters on the requested drive number only (DL); all 
other passed parameters are not checked lor validity. If you pass invalid parameters, 
the results are unpredictable. 


On return from this serv ice, the carry flag signifies whether an error occurred. 
If the earn' flag is not set. Al I contains a zero (0)- If the carry flag is set, AH contains 
the disk status byte as detailed in sen-ice 13/1 (refer to table 20.6). 


Alternate Reset (Interrupt 13h, service ODh) 

Category: Disk services 

Registers on Entry: 

AH: ODh 

DL* Fixed disk drive number 

Registers on Return: 

AH Return code 

* • 

Memory Affected: None^ 

Syntax: 

MOV DL,80h ;Use first disk drive 

MOV AH,0On {Specify service Dh 

INT I3h ;BI0S disk interrupt 

Description: This sen-ice, which is available only on the IBM Personal Computer 
AT , resets the fixed disk drive. 

i 

The IBM Personal Computer AT BIOS shows that, after compensating for the 
fixed disk drive specification, this senice is hard-coded to the same routine address 
as service 13/0; there is absolutely no difference between the two services. This 
sen'ice apparently was included for future expansion—for the day wnen identical 
reset routines could not be used for both fixed and floppy disks. 

To use this senice, you must specify the fixed disk drive number (80h for the 
first fixed disk, 81h for the second, etc.) in DL. These numbers do not correspond 
to the standard BIOS disk-numbering scheme. If you attempt the service with any 
out-of-range fixed disk drive numbers (those below 80h), an error will be returned. 

When this senice is called, its effect on the fixed diskdrive is not apparent. The 
recalibrate command is sent directly to the fixed disk controller, and a reset flag is 
set to recalibrate the drive the next time it is used. (This recalibration consists 
primarily of retracting the read/ write head to track 0 .) 
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Used primarily in routines that handle critical errors, this service forces the 
controller to recalibrate itself on the subsequent operation. If a critical error occurs, 
this service is necessary for reliable operation of the fixed disk. The service forces the 
controller to make no assumptions about its position or condition—assumptions 
that may be wrong because of the previously experienced critical-error condition. 

On return from this service, the carry flag signifies whether an error occurred. 
If the carry flag is not set, AH will contain a zero (0). If the carry flag is set, AH contains 
the disk status byte as detailed in service 13/1 (refer to table 20.6). 


Unused (Interrupt 13H, services Eh, Fh) 

These services, which are listed as unused in the IBM Personal Computer AT 
BIOS, more than likely will be used as peripherals as capabilities are added. 


Read DASD Type (Interrupt 13h, service 15h) 

Category: Disk services 

Registers on Entry: 

AH: 15h 

DL: Drive number 

Registers on Return: 

AH: Return code 

CX: High byte—number of fixed disk sectors 
DX: Low byte—number of fixed disk sectors 

Memory Affected: None 

Syntax: 

MOV DL,e ;Use drive A: 

MOV AH,I5h ;Specity service I5h 

INT I3h ;BI0S> disk interrupt 

Description: This service, which is available only on the PC XT (BIOS dated 
1/10/86 or later), PC XT286, IBM Personal Computer AT, or PS/2 tine, is used to 
determine the Direct Access Storage Device (DASD) type of a given disk drive. 
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Dl.can contain either a normal IJIOS disk drive number (0=A, 1 = B, 2*C,ctc.) 
or a fixed disk drive number (801. for .he firs, fixed d.sk, 81 h for .he second, etc ). 

On return from this service, the carry flag signifies whether an error occurred. 
If the carry flag is set, AH contains the disk status byte as detailed in service 13/1 (refer 
to table 20.6). If an error occurs, use service 13/0 to reset the disk system before you 
attempt to use this service again. 

If the carry flag is clear, the return code in AH indicates the DASD type of the 
drive. Table 20.9 lists the possible return codes and their meanings. 


Table 20.9. DASD types for service 13/15- 


Code 


Meaning 

The drive requested (DL) is not present 
Drive present, cannot detect disk change 
Drive present, can detect disk change 
Fixed disk 


If the return code indicates a DASD type of 3 (fixed disk), the register pair 
CX:DX will indicate the number of sectors on the fixed disk. 


Read Disk-Change Line Status (Interrupt 13h, service l6h) 

Category': Disk services 

Registers on Entry: 

AH: I6h 

DL: Drive number 

Registers on Return: 

AH: Return code 

Memory Affected: None 

Syntax: 

mov DL.0 ;Use drive A: 

MOV AH,16h ;Specify service 16h 

INT I3h ;BIOS disk interrupt 
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Description: I’se this sen ice. which is available only on the PC XT (DIOS dated 
J/10186 or later). PC XT286. IBM Personal Computer AT. or PS/2 line, to determine 
whether the disk in a drive has been changed. 

The result code in AH will be either a zero (0) or a 6. A 0 means that the disk 
has not been changed: a 6 means that it has. If the disk has not been changed, the 
earn’ flag will be clear; if the disk has been changed, the carry flag will be set. 

1 he use of the carry flag can have strange consequences in this service. The 
carry flag is set no; only if an error has occurred but also if the disk has been changed. 
Because having two uses for the carry flag can be confusing, be sure to check the 
contents of AH for the true result code. If AH is 0. and the carry flag is set. you know 
that an error has occurred. AH can then be assumed to contain the disk status byte 
as detailed in service 13/1 (refer to table 20.6). 

Even if no disk is in the drive, this service works and does not gene: ate an error. 
The drive is activated and checked; if no disk is present, a result of 6 is returned. If 
this service is called several times with no intervening disk access, the same result 
code is returned repetitively. For instance, if you request a disk’s directory and then 
invoke this service, a result code of 0 is returned. If you then change the disk, a result 
code of 6 is generated. If you leave the same disk in the drive and again call this 
service, a result code of 6 is again returned. A result code of 0, indicating that no 
change has occurred, is returned only after the disk has been read. 


Set DASD Type for Format (Interrupt 13h, service 17h) 

Category: Disk services 
Registers on Entry: 

AH: 17h 

AL: DASD format type 

DL: Drive number 

Registers on Return: Unchanged 

Memory Affected: None 

Syntax: 

MOV AL,3 ;Set DASD for 1.2M 

MOV dl,® ;Set drive A: 

MOV AH,i7h ;Specify service I7h 

1NT I3h ;BI0$ disk interrupt 
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„ Us , this service wi.h service 13/5 to format a disk. You must use this 

^XcbisavaUabl, only on ,he PC XT (BIOS daUd lUOmorlaleOPCXT 
286 mi Personal Con,paler AT, or PS/2 line, to specify not only the type of disk to 
format but also the type of drive in which that disk will be formatted. 

The DASD format type specified in AL can be a number from 1 to 3 (see 
table 20.10). 

Table 20.10. DASD format types for service 13/17. _ 


Type 


Meaning __ 

Formatting a 320/360K disk in a 320/360K drive 
Formatting a 320/360K disk in a 1.2M drive 
Formatting a 1.2M disk in a 1.2M drive 
Formatting a 720K disk in either a 720K or 1.44M drive 


For more information on the proper use of this service, see the discussion and 
sample routines for service 13/5. 


Set Media Type'for Format (Interrupt 13h, service 18h) 

Category: Disk services 
Registers on Entry: 

AH: 18h 

CH: Number of tracks 

CL: Sectors per track 

DL: Drive number (zero based) 

Registers on Return: 

DI: Oilsei address of 11 -byte parameter table 

E S: Segment address of 11-byte parameter table 

Memory Affected: None 

Syntax: 

MOV CH.30 ;Set for 40 tracks 

MOV CL,9 »Sst 9 sectors 

MOV DL,0 ;S 0 t drive A: 
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MOV AH,1 Eli ;Specify service I8h 

INT I3!i ;BIOS disk interrupt 

Description: This scmcc. which is available only on the PC XT (BIOS dated 1/10/ 
86 or later), PC XT 286, IBM Personal Computer AT, or PS/2 line, specifies to the 
formatting routines the number of tracks and sectors per track to be placed on the 
media. Normally, you will not use this service; it makes possible the creation of 
nonstandard track layouts. 


Park Heads (Interrupt 13h, service 19h) 

Category: Disk services 

Registers on Entry: 

AH: 19h 

DI.: Drive number, zero-based and HD-coded 

Registers on Return: Not significant 
Memory Affected: None 
Syntax: 

MOV DL,80h {First fixed drive (C:) 

MOV AH,l9h ;Request park heads service 

INT 13h ;BI0S disk service interrupt 

Description: This service, which is available only on the PC XT (BIOS dated 
1/10/86 or later), PC XT286, IBM Personal Computer AT, or PS/2 line, moves the 
heads of the specified fixed disk drive to a “safe” storage position. 


Format ESDI Unit (Interrupt 13h, service lAh) 

Category: Disk services 
Registers on Entry: 


AH: lAh 

AL: 0 = no defect table 

< > 0 = use defect table 
ES: Segment address of defect table 

bX: Offset address of defect table 

CL: modifier bits: 
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Bits 

76543210 Meaning 


1 

xxx 


1 


Ignore primary defect map 
Ignore secondary defect map 
Update secondary defect map 
Perform extended surface analysis 
Turn periodic interrupts ON 
Reserved 


DL: Drive number (zero based) 

Registers on Return: Not significant 
Memory Affected: None 


Description: This service, which is available only on the PS/2 line models 50, 60, 
and 80, reformats an ESDI disk unit. You should never need to use it. 


Initialize Communications Port (Interrupt I4h, service 0) 

Category: Communications services 
Registers on Entry: 


AH: 0 

AL: Initialization parameter 

DX: Communications port 

Registers on Return: 

AH: Line status 

AL: Modem starus 


Memory Affected: None 
Syntax: 

MOV AL,10000011b 
MOV OX,0 
MOV AH,0 
INT 14h 


;Set for 1200/N/e/l 
;Set C0M1: 

;Specify service 0 
;6I0S comm, interrupt 


Description: This service is used to initialize the communications ( RS-2*2* nnrt 
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n AL, you specify how the communications port should be initialized. This 
serv ice allows you to set the baud rate, parity, data length, and stop bits. Specif/ these 

sett,ngs through the bits of register AL, according to the coding scheme shown in 
table 20.11. 

Table 20.11. Meaning of AL bits for service 14/0. 

Bits 

76543210 Meaning 


000 

110 baud 

901 

150 baud 

919 

300 baud 

011 

600 baud 

100 

1200 baud 

101 

2400 baud 

110 

4800 baud 

111 

9600 baud 

00 

No parity 

01 

Odd parity 

10 

No parity 

11 

Even parity 

0 

1 stopbit 

1 

2 stopbits 

10 

7 -bit data length 

11 

8 -bit data length 


This service returns two values, which correspond to the asynchronous chip’s 
line status (AH) and modem status (AL) registers. These return values, which 
indicate the status and condition of the asynchronous communications adapter, are 
the same as those returned in service 14/3 The meaning of each bit of the line status 
register is shown in table 20.12; table 20.13 lists the meaning of the modem status 
register. 
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Table 2012- The line status register I ■leaning 


Hits 


76543210 

Meaning _ _ _ 


1 

Time-out error 


1 

Transfer shift register (TSR) empty 


1 

Transfer holding register (THR) empty 


1 

Break interrupt detected 


1 

Framing error 


1 

Parity error 


1 

Overrun error 


1 

Data ready 



Table ^ 0.13 • 

The modem status register Jit meanings. 


Bits 



76543210 

Meaning 


1 

Receive line-signal detect 


1 

King indicator 


1 

Data set ready (DSR) 


1 

Clear to send (CTS) 


1 . 

Delta receive line-signal detect 


1 

Trailing-edge ring detector 


1 

Delta data-set ready (DDSR) 


1 

Delta clear to send (DCTS) 



Note that the value in AH, which corresponds to the line status register, has an 
added bit. Although the meaning of bit 7 in the line status register ordinarily * 
undefined, BIOS uses this bit to signal that an excessive amount of time has passed 
since a character has been received. 

This book does not attempt to explain the purpose, use, and interpretation of 
each bit in these registers. Many books on asynchronous communications are 
available. 
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Transmit Character (Interrupt 14h, service 1) 

Category: Communications services 
Registers on Entry: 

AH: 1 

AL: ASCII character 

DX: Comrn.'jriiCations port 

Registers on Return: 

AH: Return code 

Memory Affected: None 

Syntax: 


MOV 

al, *r 

;Send the letter *T* 

MOV 

OX, 0 

;Set COMi: 

MOV 

AH, 1 

;Specify service 1 

INT 

14h 

;BI0S conun. interrupt 


Description: This service sends a character to the communications (RS-232) port 
specified in DX. The contents of DX can vary from 0 to 3 (corresponding to COM1 
COM2:, COM3;, and COM4:). Before calling this service for the first time, make sure 
that service 14/0 has been used to initialize the communications port. 

The character to be sent should be loaded in AL. The transmission ^vas success* 
ful if the high-order bit of AH is dear (£H < 80h) on return. Table 20.12 shows the 
balance of the bits in AH after a successful transmission. 

If the transmission was unsuccessful, the high-order bit will be set (AH > 7Fh) 
and the balance of AH will appear as in table 20.12. 



Receive Character (Interrupt 14h, service 2) 

Category: Communications services 
Registers on Entry: 

AH: 2 

DX: Communications port 

Registers on Return: 

Return code 
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Memory Affected: None 

Syntax: 


MOV DX.e 

;Set COMi: 

MOV AH.2 

;Specify service 2 

INT 14h 

;BIOS com. interrupt 


Description: This service is used to receive a character from the communications 
(RS-232) port specified in DX. The contents of DX can vary from 0 to 3 (correspond¬ 
ing to COM1:, COM2:. COM3:, and COM4:). Before calling this SSTVKS for the first 
time, make sure that you have used service 14/0 to initialize the communications 

port. 

B era u*'* this service waits for a character, other computer processing is 
suspended until the character is received or until the communications port returns 

an error. 

On return, AH contains a return code. In this return code, which is analogous 
to the line control register’s return values of service 14/3, only the error bits are used 
(refer to table 20.12). 

If you set AL to w before calling this service, you can quickly test whether a 
character was received. Because most receiving software discards NULLL characters 
(ASCII value of 0), no action need be taken even if a null! character is received; your 
routine can continue to wait for an incoming character. 

Get Communications Port Status (Interrupt I4h, 
service 3) 

Category: Communications services 
Registers on Entry: 

AH. 3 

DX: Communications port 

m 

Registers on Return: 

AH Line status 

AL: Modem sutus 

Memory Affected: None 
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Syntax: 

MOV OX,0 

;Set comi: 

MOV 

AM,3 

;Specify service 3 

I NT 

14h 

•BIOS comm, interrupt 


°t!f rip ^ n ’ USC ,hls . servlce to chcck thc *wtus of the communications line and t he 
modem. The communications (RS-232) pon is specified in DX. The contents ol DX 
can vary from 0 to 3 (corresponding to COM1:, COM2:, COM3:, and COM4:) 

This service returns two values, which correspond to the asynchronous chip’s 
ne status (AH) and modem status (AL) registers. The meaning of each line status 

bl * b ShOW " in 20 12; of each modem sutus register bit, in 
.able 20.13. 

Notice that the value in AH, which corresponds to the line sutus register, has 
an added bit. Although the meaning of bit 7 in the line sutus register is undefined, 

BIOS uses this bit to signal that too much time has passed since a character has been 
received. 

This book docs not attempt to explain the purpose, use, and interpreution of 
each bit in these registers. Many books on asynchronous communications are 
available. 


Extended Communications Port Initialization 
(Interrupt I4h, service 4) 

Category: Communications services 


Registers oo Entry: 

AH: 

04h 

Al: 

OOh = no break 

Olh = break 

BH: 

OOh = no parity 

Olh = odd parity 
02h = even parity 
03h = mark parity 
04 h = space parity 

BL: 

OOh * one stop bit 
Olh = two stop bits 

CH: 

OOh " 5 dau bits 
Olh ■ 6 dau bits 

• 

02h ■ 7 dau biu 
03h ■ 8 dau biu 
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CL: OOh « 110 BPS 

01 h =-* 150 BPS 
02h = 300 BPS 
03h ■ 000 BPS 
04h = 1200 BPS 
05h = 2400 BPS 
06h * 4800 BPS 
07h = 9600 BPS 
08h = 19200 BPS 

DX: Serial port (0=COM 1, etc.) 

Registers on Return: 

AH: Port status (table 20.12) 

AL. Modem status (table 20.13) 

Memory Affected: None 


Syntax: 


MOV 

AH,04h 

;extended initialization function 

MOV 

AL,0 

;no break 

MOV 

BH, 2 

;even parity 

MOV 

BL, 0 

; 1 stop bit 

MOV 

CH, 2 

;7 data bits 

MOV 

CL,4 

;1200 BPS 

MOV 

DX,0 

;C0M1 

INT 

141) 

;communications service 


Description: This service, available only on the PS/2 line, greatly simplifies the 
initialization of the communications ports. 


Extended Communications Port Control 
(Interrupt l4li, service 5) 

Category: Communications services 

Registers on Entry: 

AH: 05h 

AL: 00h, Read modem control register 

Olh. Write modem control register 
BL: New MCR content if AL=01 h 

DX: Serial port (0 « COM1. etc.) 
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Registers on Return: 

AH: Port status (table 20.12) 

At: Modem status (table 20.13) 

BL: Modem control register (see Chapter 18): 


Bits 

76S43210 Meaning 

1 Data terminal ready (DTR) 
1 Request to send (RTS) 

1 User 1 

1 User 2 

1 Loopback test 

xxx Reserved 


„ Memory Affected: None 


Syntax: 

MOV AH,05h 

MOV AL,0 

MOV OX,9 

INT 14h 


;extended MCR control function 

;read MCR 
;C0M1 

;communications service 


Description: This service, available only on tbe PS/2 line , greatly simplifies modem 
control through the communications ports. 


Turn On Cassette Motor (Interrupt 15h, service 0) 

Category: Cassette services 
Registers on Entry: 

AH: 0 

Register* on Return: 

AH: Return code 

Memory Affected: None 
Syntax: 

90V AH,• ;Specify service t 

IMT I5h ;BI0S cassette interrupt 
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Description: This service (the opposite of service 15/1) turns on the cassette motor. 
Because this service works only on older models of the PC. using it on the IBM Pc 
XT or Personal Computer AT causes the return of an 86h in AH and sets the carry flag. 


Turn Off Cassette Motor (Interrupt 15h, service 1) 

Category: Cassette services 
Registers on Entry: 

AH: 1 

Registers on Return: 

AH: Return code 
Memory Affected: None 
Syntax: 

MOV AH,1 ;Specify service 1 

INT 15h ;BIOS cassette interrupt 

Description: This service (the opposite of service 15/9) turns off the cassette motor. 
Because this service works only on older models of the PC, using it on the IBM PC 
XT or Personal Computer AT causes the return of an 86h in AH and sets the carry flag. 


Read Data Blocks from Cassette (Interrupt 15h, service 2) 

Category: Cassette services 
Registers on Entry: 

AH: 2 

BX: Offset address of data buffer 

CX: Number of bytes to read 

ES: Segment address of data buffer 

Registers on Return: 

AH: Return code 

DX: Number of bytes read 

Memory Affected: RAM buffer area specified by address starting at ES:BX is 
overwritten with bytes requested from cassette. 
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Syntax: 

MOV CX,NUM_BYTES 

;Read this many bytes 

PUSH 

OS 

;Point ES to proper 

POP 

ES 

; segment address 

MOV 

BX,OFFSET ES:BUFFER 

;Offset of buffer area 

MOV 

AH,2 

;Specify service 2 

INT 

15h 

;BI0S cassette interrupt 


Description: This service reads data from the cassette-tape port. Because this 
service works only on older models of the PC, using it on the IBM PC XT or Personal 
Computer AT causes the return of an 86h in AH and sets the carry flag. 

Infonttau*^ is read from the cassette in 256-bytc blocks, but only the num¬ 
ber of bytes requested in Ca 2TZ transferred to the memory address pointed to by 
ES:BX. 

X 

On completion, DX is set to the number of bytes actually read, it uC TTTor 
occurred, the carry flag is dear; if an error occurred, the carry flag is set and AH will 
contain an error code. The error codes shown in table 20.14 are valid only if the carry 
flag is set. 


Table 20.14. Error codes returned in AH for service 15/2. 

Code 

Meaning 

Oh 

Invalid command 

lh 

CRC error 

2h 

Data transitions lost 

3h . 

No data located on tape 

86h 

No cassette port available 


Write Data Blocks to Cassette (Interrupt 15h, service 3) 

Category: Cassette services 
Registers on Entry: 

AH: 3 

BX: Offset address of data buffer 

CX: Number of bytes to write 

ES: Segment address of dau buffer 
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Registers on Return: 
ah. Return code 
Memory Affected: None 
Syntax: 

MOV CX,NUMBYTES 

PUSH DS 

POP ES 

MOV BX,OFFSET ES:BUFFER 

MOV AH,3 

INT 15h 

Description: This service writes data me ca^jjctte.tape port. Because this service 
works only on old^' , n0< j e | s Q f ihe PC. using it on the IBM PC XT or Personal 
^CTiputer AT causes the return of an 86h in AH and sets the carry flag. 

Information is written to the cassette in 256-byte blocks, but only the number 
of bytes indicated in CX arc transferred from the memory address pointed to by 
ES:BX. 

If an error is detected when this service is invoked, the carry flag is set and AH 
will contain an error code (see table 20.15). These error codes, which are valid only 
if the carry flag is set, indicate only syntactical errors. Neither of the errors returned 
indicates that information was written improperly to the cassette. 


Table 20.15 • Error codes returned in AH for service 15/3. 

Code 

Meaning 

Oh 

Invalid command 

86h 

No cassette port available 


;Write this oany bytes 
;Point ES to proper 
; segment address 
;0ffset of buffer area 
;Specify service 3 
;BI0S cassette interrupt 


ESDI Format Hook (Interrupt 15h, service OFh) 

Category: PS/2 services 

\V 

Registers X>n Entry: 

AH: OFh 

AL: Olh = Surface analysis 

02h = Formatting 
Other values reserved 
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Registers on Return: 

Carry flag set if formatting is to stop 
AH: 86h if service not available 

Memory Affected: None 

Description: This service, available only on the PS/2 line, is called by the ESDI 
format service after each cylinder is formatted or analyzed. If you want to perform 
some action at that time, you can set the INT 15h vector to your own routine, trap 
the condition of AH=0Fh, and chain on to the existing BIOS code for all other 
conditions. Most programmers will never use this service. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 

On return from this service, the carry flag signifies one of rwo things: If the carry 
flag is set and AH contains 86h, the service is not available; if AH contains come other 
value, formatting is to stop. 


Keyboard Intercept Hook (Interrupt 15h, service 4Fh) 

Category: PS/2 services 
Registers on Entry: 

AH: 4Fh 

AL: Keyboard scan code 

Registers on Return: 

AL: New scan code if changed, original code otherwise 

Memory Affected: None 

Description: This service, available only on the PS/2 line (except Model 30), is 
called by the BIOS routine that services INT 09h whenever a scan code is received^ 
from the keyboard. If you want to provide special processing, you can intercept this 
service to do so. Normally, this service is never called by a programmer. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


| 

I 
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Device Open (Interrupt 15h, service 80h) 


Category: PS/2 services 

Registers on Entry*: 

AH: 80h 

BX: Device ID code 

CX: Process ID code 

Registers on Return: 

AH: Return code 

Memory Affected: None 


Syntax: 


MOV 

MOV 

MOV 

IN7 


BX.DEVin 

CX.PROCID 

AH,80h 

*.5h 


;device affected 
;process owning device 
;service code 
;B!OS extension interrupt 


Description: This service, available only on systems dated since 11/08/82, is part of 
the networking and multitasking interface; as such, its use is beyond the scope of this 
book. 


If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Device Close (Interrupt 15h, service 81h) 

Category: PS/2 services 
Registers on Entry: 


AH: 

81h 

BX: 

Device ID code 

CX: 

Process ID code 

Registers on Return: 

AH. 

Return code 


>K mory Affected: None 
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Syntax: 


MOV BX.OEVID 

;device affected 

MOV CX.PROCIO 

;proce$s owning device 

MOV AH.Blh 

; service code 

INT 15h 

;BIOS extension interrupt 

Description: This service, available only on systems dated since 11/08/82, is pan of 
the networking and multitasking interface; its use is beyond the scope of this book. 

a i 4 f lf QnlI ed ° n 0ldcr PC modcls ' lhis semce sets the carry flag and returns 86h in 

u ^° r j ° n or *^ na * anc * PQ r models) to indicate that the service is invalid on 
the model. 

Terminate Program (Interrupt 15h, service 82h) 

Category: PS/2 services 

Registers on Entry: 

AH: 82h 

BX: Process ID code 

Registers on Return: 

AH: Return code 

Memory Affected: None 

Syntax: 

MOV BX.PROCID 

;process to terminate 

MOV AH,82h 

;service code 

INT 15h 

;BI0S extension interrupt 


Description: This service, available only on systems dated since 11/08/82, is pan of 
the networking and multitasking interface; its use is beyond the scope of this book. 

If called on older PC models, this service sets the carry flag and returns 86h in 

AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 
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Event Wait (Interrupt 15h service 83h) 

Category: PS/2 services 
Registers on Entry: 

AH: 83h 

AL: OOh = Set interval 

01 h = Cancel interval already set (PS/2 only) 

BX: Offset address of byte to set when time expires 

CX: High-order value of microseconds until posting 

DX: Low-order value of microseconds until posting 

ES: Segment address of byte to set when type expires 

Registers on Return: 

AH: Return code 

Memory' Affected: High-order bit of byte addressed by ES:BX is set as soon as 
possible after the requested time interval expires. Maximum time that can be set is 
approximately 70 minutes (2’ 2 microseconds). 


Syntax: 



MOV 

AH,83h 

jservice code 

MOV 

AL.COh 

;set an interval 

MOV 

BX,OFFSET RByte 


PUSH 

DS 


POP 

ES 


MOV 

CX,0 

;high word of time count 

MOV 

DX,10000 

;wait 1/100 second 

INT 

15h 

;B10S extension interrupt 


Description: This service, available only on systems dated since 11/D8/82, is pan of 
the networking and multitasking interface; its use is beyond the scope of this book. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and-PCjr models) to indicate that the service is invalid for 
the model. 


Joystick Support (Interrupt 15h, service 84h) 

Category: Miscellaneous services 


Scanned by CamScanner 





Registers on Entry: 

AH: 84h 

DX: 00h * Rea d sw ‘tches 

Olh = Read joystick position 


Registers on Return: 

If reading switches (DX=0): 

AJL = Switch settings (bits 4*7) 
If reading position (DX= 1): 

AX = A(X) value 
BX = A(Y) value 
CX = B(X) value 
DX = B(Y) value 

Memory Affected: None 


Syntax: 


MOV 

MOV 

INT 


AH,84h 
DX,1 
15h 


;joystick service 

;read position 

;BIOS extension interrupt 


TMT 15h jBlua ca — 

Description: With this service. 

released since 1983. you can read e.ther the |Oyst.c 

AL=0) or the joystick position. - in 

the model. 


SysRq Key Pressed (Interrupt 15h, service 85h) 

Category: Miscellaneous services 
Registers on Entry: 

AH: 85h 

AL. OOh = SysRq key pressed 
Olh = SysRq key released 


Registers on Return: 

AH: Return code 

Memory Affected: None 
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Description: This serv ice, available only on IBM PC and PS/2 systems released 
since 1983 , is meaningful only when the keyboard includes the SysRq key (8-i-ki v 
and later designs). BIOS calls the service when I NT 09h detects either a press or 
release of the SysRq key. Normally, programmers never call this service. 

To provide special action when the key is pressed, your program must replace 
the existing INT15h service routine with a new one that traps the condition AH=85h 
and passes control on to the original routine for all other cases. Your routine can 
then determine whether the key was pressed or released by testing the content of 
the AL register. Be sure to remove your special routine before returning to DOS. 

On return from this service, the carry flag signifies whether an error occurred. 
If the carry flag is set and AH contains 86h, this service is not available. 


Delay (Interrupt 15h, service 86h) 

Category: Miscellaneous services 
Registers on Entry’: 

AH: 86h 

CX: High-order value of delay time in microseconds 

DX: Low-order value of delay time in microseconds 

Registers on Return: 


AH: Return code 

Memory Affected: None 


Syntax: 


MOV AH,86h 

MOV CX,0 

MOV OX,10000 

INT 15h 


;delay service 
;high 16 bits of value 
;wait 1/100 second 
;BI0S extension interrupt 


Description: This service, which is available only on the IBM Personal Computer ' 
AT and PS/2 lines, pauses a specified length of time before returning to its caller The 
service is intended for system use only, not for general application. 


If called on older PC models, the service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that service is invalid on the 
model. 
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Move Block to/from Extended Memory 
(Interrupt 15h, service 87h) 

Category: Miscellaneous services 
Registers on Entry: 

AH: 87h 

CX: Number of words to move 

ES: Segment address of GDT (see table 20.16) 

SI: Offset address of GDT (see table 20.16) 

Registers on Return: 

AH: Return code 

Memory Affected: As described by GDT values 
Syntax: 

MOV AH, 87h ;move block 

MOV CX, 40 ;8© bytes 

MOV ES, SEG GDT ;set table address 

M^V SI, OFFSET GDT 

jnt i5h ;BI0S extension interrupt 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines , moves data to or from extended memory as described by the global 
descriptor table (GDT) (see table 20.16). This service cannot transfer more than 64K 
bytes of data at one call. 


Table 20.16. Format of global descriptor table. 

Offset 

Description 

OOh 

Dummy, set to zero 

08h 

GDT data-segment location, set to zero 

lOh 

Source GDT, points to 8-byte GDT for source memory block 

18h 

Target GDT, points to 8-byte GDT for target memory block 

20h 

Pointer to BIOS code segment, initially zero 

28h 

Pointer to BIOS stack segment, initially zero 


Source/target GDT layouts 

OOh 

Segment limit 

02h 

24-bit segment physical address 

05h 

Data access rights (set to 93h) 

06h 

Reserved word, must be zero 
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If called on older PC models, this service sets the carry flag and returns 86h in 
Al l (or 80h on original PC and PCjr models) to indicate that the service is invalid on 

the model. 


Size Extended Memory (Interrupt 15h, service 88h) 

Category’: Miscellaneous services 
Registers on Entry: 

AH: 88h 

Registers on Return: 

AX: Number of contiguous IK blocks of RAM above lOOOOOh 

Memory Affected: None 

Syntax: 

MOV AH,88h ;get extended RAM size service 

INT I5h ;BIOS extension interrupt 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines, returns the amount of “extended” memory available above the normal 
1M limit. The service is meaningful only for machines equipped with the 30286 (or 
later) CPU chip. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Protected Mode Switch (Interrupt 15h, service 89h) 

Category: Miscellaneous services 
Registers on Entry: 

AH: 89h 

BL: IRQO vector offset 
BH: IRQ8 vector offset 
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CX: Offset into protected-mode CS to jump to 

ES: Segment address of GDT (sec table 20.16) 

SI: Offset address of GDT (see table 20.16) 

Registers on Return: 

AH: Return code 

Memory Affected: None 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines , switches the CPU into protected-mode operation so that you can access 
directly the full 16M address range. The service is meaningful only for machines 
equipped with the 80286 or later CPU chip. 

You are not likely to use this service with any DOS programs you write because 
DOS cannot use protected-mode operation. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Get System Configuratiop (Interrupt 15h, service COh) 

Category: PS/2 services 
Registers on Entry: 

AH: COh 

Registers on Return: 

BX: Offset address of system-configuration table 

ES: Segment address of system-configuration table 

Memory Affected: None 

Syntax: 

MOV AH,C0h ;request Qet configuration service 

INT ish ;BI0S extension interrupt 


Scanned by CamScanner 


550 Pan IV: Reference 


Description: This service, which is available only on PC and PS ’2 models dated after 
01 lOfbi, returns a pointer to the system descriptor dibit*. Table 20.17 shows the 
layout of this area; tables 20.18 and 20.19 provide more detail. 


Table 20.17. 

System descriptor table. 

Offset 

Meaning 

* 

OOh 

Byte count of subsequent data (minimum 8) 

02h 

Model byte (see table 20.19 for meaning) 

03 h 

Submodel byte (see table 20.19 for meaning) 

04h 

BIOS revision level (00 = first release) 

05h 

Feature information (see table 20 .18 for meaning) 

06-09h 

Reserved 

• 


Table 20.18. 

Feature information byte. 

Bits 



76543210 

Hex Decimal 

Meaning of Bits 

1 

80 128 

DMAschannel 3 used hy hard disk BIOS 

1 

40 64 

Second interrupt chip present 

1 

20 32 

Real-time clock present 

1 

10 16 

Keyboard intercept called by INT 09b 

1 

S 8 

VC ait for external event is supported 

1 

4 4 

Extended BIOS data area allocated 

1 

2 2 

Micro channel architecture 

0 


PC bus I/O channel 

X 


Reserved 
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Table 20.19. System model identification. 


Computer 

Type 

Model 

Byte 

(offset 

02b) 

Submodel 

(offset 

03b) 

BIOS 

Revision 

(offset 

Oib) 

BIOS 

Dale 

PC 

FFh 




PC XT 

FEh 




PC XT 

FBh 

OOh 

Olh 

1/10/86 

PC XT 

FBh 

OOh 

02h 

5/09/86 

PCjr 

FDh 




AT 

FCh 




AT 

FCh 

OOh 

Olh 

6/10/85 

AT, COMPAQ 286 

FCh 

Olh 

OOh 

11/15/85 

PC XT 286 

FCh 

02h 

OOh 


PC Convertible 

F9h 

OOh 

OOh 


PS/2 Model 30 

FAh 

OOh 

OOh 


PS/2 Model 50 

FCh 

04 h 

OOh 


PS/2 Model 60 

FCh 

05h 

OOh 


PS/2 Model 80 

F8h 

OOh 

OOh 



If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Get Extended BIOS Address (Interrupt 15h, service Clh) 

Category: PS/2 services 
Registers on Entry: 

AH: Clh 

Registers on Return: 

AH: Return code 

ES: Extended BIOS Data Area s segment address 
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Memory Affected: None 
Syntax: 

MOV AH,Clh ;request service 

INT 15h ;BIOS extension interrupt 

Description: This service, available only on the PS/2 line, sets the ES register to 
point to the Extended DIOS Data Area's segment address: it is meaningful only if the 
feature-information byte (refer to table 20.18) of service 15/CO indicates that such 
an area has been allocated. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Pointing Device Interface (Interrupt 15h, service C2h) 

Category: PS/2 services 

Registers on Entry: 

AH: C2h 

AL: OOh = Enabie/disabic device 

Olh = Reset device 
02h = Set sampling rate for device 
03h = Set resolution of device 
04h = Read device type 
05h = Initialize device interface 
06h = Indicate extended commands for device 
07h = Initialize FAR call device 

BH: OOh = Enable (ifAL=0) 

Olh = Disable (if AL=0) 

Registers on Return: 

AH: Return code 


Memory Affected: None 


Syntax: 

;enable/disable subfunction 
;enable pointing device 
;request service 
jBIOS extension interrupt 


MOV 

AL.Oeh 

MOV 

BH,OOh 

MOV 

AH,C2h 

INT 

15h 
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Description: This service, available only on the PS/2 line, need never be called by 
your programs; the standard mouse interface of 1NT 33h uses this service, if 
applicable, so that your programs can communicate with pointing devices by using 
the 1NT 33h interface. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid with 
the model. 


Watchdog Timer (Interrupt 15h, service C3h) 

Category: PS/2 services 
Registers on Entry: 

AH: C3 

AL: OOh = Disable timer 

Olh = Enable timer „ 

BX: Timer count (1-255) 

Registers on Return: Unchanged 
Memory Affected: None 
Syntax: 


MOV 

BX,182 

;set alarm for 182 ticks (approx 10 sec) 

MOV 

AH,C3h 

;request service 

MOV 

AL,01h 

;enable timer 

I NT 

15h 

;BI0S extension interrupt 

■ • 

• 

1 • 

do something that must complete within 10 seconds 

I • 

MOV 

AH,C3h 

;request service 

MOV 

AL,00h 

;disable timer 

INT 

15h 

;BI0S extension interrupt 


Description: This service, available only on tbe PS/2 line, sets a “watchdog" alarm 
based on the 18.2-tick/second main timer cycle. If you call this service to enable the 
timer with a count from 1 to 255 in the BX register and fail to call the service again 
before the count reaches zero, a nonmaslcable interrupt (1NT 02h) is generated. The 
count decrements by one at each timer tick. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 
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Programmable Option Select (Interrupt 15h, service C4h) 

Category: PS/2 services 

Registers on Entry: 

AH: C4h 

AL: OOh = Return base POS register address 

Olh = Enable slot for setup 
02h = Enable adapter 

Registers on Return: 

DL: Base POS register port address (if AL=0) 

BL: Slot number (if AL= 1) 

Memory Affected: None 

S.mtax: 

MOV AL,00h ;get address to OL 

MOV AH,C4h ;request service 

INT I5h ;BIOS extension interrupt 

Description: This service, available only on the PS/2 lit.j, eliminates the need to set 
DIP switches. Instead, programmable registers accessed by this service establish 
options for the various plug-in boards. 

Note: Using this service improperly can cause physical damage to some plug¬ 
in boards. Be sure that you know exacdy what your program is doing, and why, 
before attempting to use this service. 

If called on older PC models, this service sets the carry flag and returns 86h in 
AH (or 80h on original PC and PCjr models) to indicate that the service is invalid on 
the model. 


Read Keyboard Character (Interrupt l6h, service 0) 

Category: Keyboard services 

Registers on Entry: 

AH: 0 
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Registers on Return: 

AH: Keyboard scan code 

AL: ASCII value of keystroke 

Memory Affected: None 

Syntax: 

MOV AH,® {Specify service 0 

INT 16h {BIOS keyboard interrupt 

MOV SCAN_C0DE,AH fStore scan code 

MOV ASCII_KEY,AL {Store ASCII value 

Description: This service, which is similar to service 16/1, examines the keyboard 
buffer to determine whether a keystroke is available If no keystroke is available, the 
service waits until a key is pressed; otherwise, the service returns the ASCII value of 
the keystroke in AL and the scan code value in aH. 

Several keys or key combinations on a standard IBM PC keyboard do not have 
a corresponding ASCII value. If these keys are pressed, this service . etums a 0 (zero) 
in AL; the value in AH still represents the appropriate scan-code value. ( For a list of 
keyboard scan codes and ASCII values, see Appendix B.) 

You cannot use this service to return a scan code for every possible keystroke 
on the keyboard. It does not return scan codes for some keys (such as the Shift, Ctrl, 
and Alt keys) that cause modification to the key(s) which follow. When these keys 
alone are pressed, no scan code is returned. However, key combinations such as 
Alt-T or Ctrl-A cause scan code/ASCII combinations to be returned. 

Some keys (such as SysRq, TitSc, and Ctrl-Alt-Del) also cause an interrupt to 
occur. This service does not trap and return these keys. 

Through this service, any ASCII value from 0 to 255 can be derived by 
combining the Alt key with the numeric keypad. For example, holding down the Alt 
key while pressing 153 on the keypad, and then releasing the Alt key, causes 0 to be 
returned in AH (scan code) and 153 to be returned in AL (ASCII value). Pressing a 
keypad number larger than 255 while holding down the Alt key causes the value 
returned in AL to be the modulo of that number divided by 256. For example, if you 
use the preceding Alt-key procedure but press 8529 on the keypad, a value of 81 (the 
remainder when 8,529 is divided by 256) is returned in AL. 
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Read Keyboard Status (Interrupt l6h, service 1) 

Category: Keyboard services 

Registers on Entry: 

AH: 1 

Registers on Return: 

AH: Keyboard scan code 

AL: ASCII value of keypress 

Memory Affected: None 

Syntax: 


MOV 

AH, 1 

;Specify service 1 

INT 

16h 

;BI0S keyboard interrupt 

J 2 

NO JOEY 

;No key available 

MOV 

SCAN_C0DE,AH 

;Store scan code 

MOV 

ASCII_KEY,AL 

;Store ASCII value 


NO_KEY: 

Description: This service, which is similar to service 16/0, examines the keyboard 
buffer to determine whether k keystroke is available. If a key is available, the aero flag 
is cleared,, the ASCII value of the keystroke is returned in AL, and the scan code value 
is returned in AH. If no keystroke is waiting, the zero flag is set on return; the contents 
of AH and AL are not significant. 

Several keys or key combinations on a standard IBM PC keyboard do not have 
a corresponding ASCII value. If these keys are pressed, this service returns a 0 (zero) 
in AL; the value in AH still represents the appropriate scan-code value. ( For a list of 
keyboard scan codes and ASCII values, see Appendix B.) 

You cannot use this service to return a scan code for every possible keystroke 
on the keyboard. It does not return scan codes for some keys (such as the Shift, Ctrl, 
and Alt keys) that cause modification to the key(s) which follow. When these keys 
alone are pressed, no scan code is returned. However, key combinations such as 
Alt-T or Ctri-A cause scan code/ASCII combinations to be returned. 

Some keys (such as SysRq, PrtSc, and Ctrl-Alt-Del) also cause an interrupt to 
occur. This service docs not trap and return these keys. 

Through this service, any ASCII value from 0 to 255 can be derived by 
combining the Alt key with the numeric keypad. For example, holding down the Alt 
key while pressing 153 on the keypad, and then releasing the Alt key, causes 0 to be 
returned in AH (scan code) and 153 to be returned in AL (ASCII value). Pressing a 
keypad number larger than 255 while holding down the Alt key causes the value 
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returned in AL to be the modulo of that number divided by 256. For example, if you 
use the preceding Alt-key procedure but press 8529 on the keypad, a value of 81 (the 
remainder when 8,529 is divided by 256) is returned in AL. ' 


Read Keyboard Shift Status (Interrupt I6h, service 2) 

Category: Keyboard services 
Registers on Entry: 


Registers on Return: 

AL; Shift status (table 20.20) 
Memory Affected: None 
Syntax: 


MOV AH,2 
INT 16h 


;Specify service 2 
;BI0S keyboard interrupt 


Description: This service returns (in AL) the keyboard s current shift status. Each 
bit of the returned value represents the state of a specific keyboard Shift kev (see 
table 20.20). 7 v 

Table 20.20. Keyboard shift-status values returned by service 16/2. 


Bits 

76543210 


Hex Decimal 


Meaning of Bits 


Insert on 
Caps Lock on 
Num Lock on 
Scroll Lock on 
Alt key down 
Ctrl key down 
Left Shift key down 
Right Shift key down 
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Your programs can use this function to check for exotic key combinations that 
serv-c as a signal 10 perform a certain task. l : or instance, you may want to minimize 
the possibility of accidentally exiting your program. Instead of using the Esc key 
(Wtiich is easy to press accidentally) to exit the program, you can set up your program 
so that the user can exit only by pressing the Ctrl-Alt-Left Shift key combination. This 
combination is unlikely to be entered by accident. 


The BIOS controls the setting of this status byte* through the keyboard 
interrupt. Whenever someone presses the Ins, Shift, Ctrl, Alt, Num Lock, or Scroll 
Lock key. BIOS changes the appropriate bits in the keyboard status byte and resumes 
waiting for another key to be pressed. 


Adjust Repeat Rate (Interrupt l6h, service 03h) 

Category': Extended keyboard services 


Registers on Entry: 

AH: 03h 

AL: OOh = Restore default values (PCjr only) 

Olh = Increase initial delay (PCjr only) 

02h = Cut repeat rate in half (PCjr only) 

03h = Do both 01 and 02 (PCjr only) 

04h = turn off keyboard repeat (PCjr only) 

05h = Set repeat rate and delay (Personal Computer AT and PS/2 on! > 
BH: Repeat delay (0-3 x 250 ms; Personal Computer AT and PS/2 only) 

BL: Repeat rate (0-31, lower values are faster; Personal Computer AT and PS/2 

only) 


Registers on Return: Not significant 
Memory Affected: None 


Syntax: 


MOV AH,03h 

MOV AL,05h 

MOV BX,0307h 

.1 16h 


;request service 
;for AT 

;delay»750 ms, rate code=7 
;BI0S Keyboard interrupt 


Description: This service, available only on tbe PCjr and on tbe IBM Personal 
Computer AT and PS/2 lines , modifies both the initial delay before repeats begin, 
and the repeat rate, of the keyboard. 
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Key-Click Control (Interrupt 16h, service 04h) 

Category: Extended keyboard services 
Registers on Entry: 


AH: 04h 

AL: 00h = Silent 

Olh = Click sounds 


Registers on Return: Not significant 
Memory Affected: None 
Syntax: 


MOV 
MOV 
I NT 


AH,04h 

AL.OOh 

16h 


;request service 
;be quietl 

;BIOS keyboard interrupt 

ssssssfiss zt h J:°: ,y on ? pcjr - ^ «• «*«— *e 

no error code. * The Service h « on other models. bu. genera.es 



Write to Keyboard Buffer (Interrupt 16h, service 05h) 

Category: Extended keyboard services 7 

Registers on Entry: 

AH. 05h 

CH: Scan code to write 

CL: ASCII code to write 

Registers on Return: 


AL = Olh if buffer full 
Memory Affected: None 


Scanned by CamScanner 



Syntax: 


MOV 

CX.0FFFFH 

MOV 

AH,05h 

INT 

•10h 

MOV 

CX, 16 

GET_C0DES: MOV 

AH,10h 

INT 

10h 

CMP 

AX ,0FFFFh 

JE 

HAVE_101 

LOOP 

GET_C0DES 

JMP 

N0_101 


write test codes 

into keyboard buf/er 

BIOS keyboard interrupt 

set loop count 

read test codes back 

BIOS keyboard interrupt 

test to see if test code came back 

found it, enhanced KB present 

else keep looking until buffer empty 

enhanced KB not present 


Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines , is meaningful only when the enhanced 101-key keyboard is being used, 
because older designs lack buffers into which the service can write. 


The syntax example shows a method for using this service (together with 
service 16/10) to determine whether the enhanced 101-key keyboard is installe . 


Get Extended Keystroke (Interrupt l6h, service lOh) 

Ca tegory: Extended keyboard services 
Registers on Entry: 

AH: 10h 

Registers on Return: Same as for service 16/0 

Memory Affected: None 

Syntax: 

MOV AH,10h ;request service 

INT i6h ;BI0S keyboard Interrupt 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines , operates exactly like service 16/0; unlike service 16/0, however, this 
service also recognizes and can distinguish between the keys added to the 101-key 
keyboard. 
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Check Extended Keyboard Status 
(Interrupt I6h, service llh) 

Category: Extended keyboard services 
Registers on Entry: 

AH: llh 

Registers on Return: Same as for service 16/1 
Memory Affected: None 

Syntax: * 

MOV AH,llh ;request service 

INT 16h ;BI0S keyboard interrupt 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines , operates exactly like service 16/1; unlike service 16/1, however, this 
service also recognizes and can respond to the keys added to the 101-key keyboard. 


Get Extended Keyboard Status Flags 
(Interrupt l6h, service 12h) 

Category: Extended keyboard services 
Registers on Entry: 

AH: 12h 

Registers on Return: Same as for service 16/2 

Memory Affected: None 

Syntax: 

MOV AH,l2h ;request service 

INT I6h ;BI0S keyboard interrupt 

Description: This service, available only on the IBM Personal Computer AT and 
PS/2 lines, operates exactly like service 16/2; unlike service 16/2, however, this 
service also recognizes the keys added to the 101-key keyboard, and can respond to 
them. 
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Print Character (Interrupt 17h, service 0) 

Category: Printer services 
Registers on Entry: 

AH: 0 

AL: Character to print 

DX: Primer to be used 

Registers on Return: 

AH: Printer status (table 20.21) 

Memory Affected: Jgfone 

Syntax: 


V?* 

AL, 

;Print an asterisk 

MOV 

DX, 0 

;Use first printer 

MOV 

AH, C 

;Specify service 0 

I NT 

17h 

;BI0S printer interrupt 


Description: This service outputs a character to a printer port. The character to be 
printed is loaded in AL; the printer to use is designated in DX. A printer designation 
of 0 to 2 is valid (0 corresponds to LPT1:, 1 to LPT2:, and 2 to LPT3:). 


The value this se.-vice returns in AH is the printer status byte. (Services 17/1 and 
17/2 also return the printer status byte in AH.) Table 20.21 lists the meaning of the 
bits in this returned byre. 


Table 20.21. Meaning of bits returned in AH for services 17/0, 17/1, and 17/2. 

Bits 

76543210 

Meaning of Bits 

1 

Printer not busy 

0 

Printer busy 

1 

Printer acknowledgment 

1 

Out of paper 

1 

Printer selected 

1 

I/O error 

7? 

Unused 

1 

Time-out 
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Initialize Printer (Interrupt 17h, service 1) 

Category: Printer services 
Registers on Entry: 

AH: 1 

DX: Printer to be used 

Registers on Return: 

AH: Printer status 

Memory Affected: None 
Syntax: 


MOV 

DX,0 

;Use first printer 

MOV 

AH, 1 

;Specify service 1 

INT 

17h 

;BI0S printer interrupt 


Description: The outputs from this service initialize the IBM- or EPSON-compatible 
printer connected to the port specified in DX. A printer designation of 0 to 2 is valid 
(0 corresponds to LPT1:, 1 to LPT2:, and 2 to LPT3 ). 

Two values (08h and OCh) are output to initialize the printer. The printer 
interprets these values as a command to perform a reset. Note that this series works 
only on IBM- and EPSON-compatible printers. Other printers may not understand 
this series and may produce unwanted results. 

The value this service returns in AH is the printer status byte. (Refer to 
table 20.21 for the meaning of the bits in this returned byte.) 


Get Printer Status (Interrupt 17h, service 2) 

Category: Printer services 
Registers on Entry: 

AH: 2 

DX: Printer to be used 

Registers on Return: 

AH: Printer sums 
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Memory' Affected: None 


Syntax: 


MOV 

DX.C 

;Use first printer 

MOV 

AH,2 

;Specify service 2 

I NT 

17h 

;BI0S printer interrupt 


Description: This service retrieves the sums of the printer specified in DX. A printer 
designation of 0 to 2 is valid (0 corresponds to LPT1:, 1 to LPT2:, and 2 to LPT3:). 

The value this service returns in AH is the printer sums byte. (Refer to 
table 20.21 for the meaning of the bits in this remmed byte.) 


Boot Process Failure (Interrupt 18h) 

# 

Category: System services 
Registers on Entry: Not significant 
Registers on Return: Not significant 
Memory Affected: None 
Syntax: 

IWT ten ;Boot failure routine 

Description: This interrupt is used when booting the computer. If the process of 
loading DOS from a disk drive fails, then this interrupt to executed. On plder IBM 
PCs it resulted in ROM BASIC being loaded. On newer machines and PC} clones, it 
generally results in display of a message indicating that the boot procesf failed. 

Warm Boot (Interrupt 19h) 

Category: System services 

Registers on Entry: Not significant 

Registers on Return: Not applicable (no return) 

Memory Affected: Contents of tftemory after invocation reflect normal memory 
conditions after a warm-booting procedure. The contents of any given free memory 
area are unpredictable. 
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Syntix: 

INT 19h ;BI0S warm boot 

Description; This interrupt, which performs a warm reboot of the computer system, 

is functionally the same as pressing Ctrl-Ait Del. 

There are differences between this method and the other methods of starting 
the computer system, however. This interrupt does not go through the power-on self 
test (POST) procedures, nor does it reset the equipment status word in memory 
(refer to Interrupt 11 h). 


Get Clock Counter (Interrupt lAh, service 0) 

Category: DateAime services 
Registers on Entry: 

AH: 0 

Registers on Return: 

AL: Midnight flag 

CX: Clock count high-order word 

DX: Clock count low-order word 

Memory Affected: None 

Syntax: 

MOV AH,® ;Specify service 0 

INT lAh ;BI0S date/time interrupt 

Description: This service retrieves the current value of the system software dock 
counter. This value is a double word register that is incremented approximately 
18.2065 times per second, starting from 0 (midnight). Midnight is assumed when the 
value of the counter reaches 1800B0h or when the counter has been incremented 
1,573,040 times. Dividing this counter value by 18.2065 indicates that this dock 
count represents 86,399.9121 seconds (a fairly accurate representation of a full day, 
because there are 86,400 seconds in a 24-hour period). 

AL is set to 1 if midnight has been passed since the last read of the dock. If 
midnight has not been passed, AL is set to 0 (zero). Invoking this service always 
causes the midnight flag to be reset to 0. 
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Set Clock Counter (Interrupt lAh, service 1) 

Category: Date/time services 


Registers on Entry: 

AH:' 1 

CX: Clock count high-order word 

DX: Clock count low-order word 

Registers on Return: Unchanged 

Memory Affected: None 

Syntax: 

MOV CX.HIGH_COUNT ;Clock high-order word 

MOV dx,LOW_COUNT ;Clock loworder word 

MO v ah, 1 ;Specify service 1 

INT 1Ah ;BIOS date/time interrupt 

Description: Th:« service sets the current value of the system software clock 
counter. This value is a double word register that is incremented approximately 
.2065 times per second, starting from 0 (midnight).. 

To determine the proper settings for any given time of day, simply determine 
the number of seconds since midnight and then multiply this number by 18.2065. 
For instance, the clock value for 14:22:17.39 (military time) would be determined 

as follows: 


l4hours*= 14*60 * 60 = 50400 

seconds 

22 minutes = 22 • 60 * 1320 

seconds 

17.39 seconds = 

17.39 = 17.39 

seconds 

Total: 

51737.39 

seconds 

Clock ticks per second = 

18.2065 

ticks 

Ticks represented: 

941956.7910 

ticks 


Because fractional ticks cannot be represented, the number of ticks is rounded 
to 941,957 (0E5F85h). CX is loaded with OEh; DX, with 5F85h. 

Be careful. Because this service performs no range checks on the values you 
specify in CX and DX, you can inadvertently specify an invalid time without any 
indication from BIOS that you have done so. (An invalid time is any value greater 
than 1800B0h, the number of ticks in a full 24-hour period.) 
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Read Real-Time Clock (Interrupt lAh, service 2) 

Category: Date/time services 
Registers on Entry: 

AH: 2 

Registers on Return: 

• 

CH: Hours (BCD) 

CL: Minutes (BCD) 

DH: Seconds (BCD) 

Memory Affected: None 

Syntax: 

MOV AH,2 
INT 1Ah 
MOV HOUR,CH 

MOV MINUTE,CL 

MOV SECOND,OH 

Description: This service, which is available only on the IBM Personal Computer 
AT, retrieves the value of the real-time clock. Remember that the values returned in 
CH, CL, and DH are in binary coded decimal (BCD) and that you must make 
allowances for subsequent calculations that use these return values. 

If the clock is not functioning, the carry flag is set on return; otherwise, the cany 
flag is clear. 


;Specify service 2 
;BI0S date/time interrupt 
;Save current hour 
;Save current minute 
;Save current second 


Set Real-Time Clock (Interrupt lAh, service 3) 

Category: Date/time services 
Registers on Entry: 

AH: 3 

CH: Hours (BCD) 

CL: Minutes (BCD) 

DH: Seconds (BCD) 

DL Daylight saving time 
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Registers on Return: Unchanged 
Memory Affected: None 


Syntax: 


MOV 

CH.HOUR 

;Get current hour 

MOV 

CL,MINUTE 

;Get current minute 

MOV 

OH,SECOND 

;Get current second 

MOV 

0L, 0 

;Normal time 

MOV 

AH ,3 

;Specify service 3 

INT 

1 Ah 

;BI0S date/time interrupt 


Description: This service, which is available only on the IBM Personal Computer 
AT, sets the real-time clock. Remember that the values specified in CH, CL, and DH 
should be in binary coded decimal (BCD). 

Dl. should be set to indicate whether the rime being set is daylight saving time. 
If DL is 0 (zero), standard time is indicated; if DLis 1, daylight saving time is indicated. 


Read Date from Real-Time Clock (Interrupt lAh, service 4) 

Category: Date/time services 
Registers on Entry: 

AH: 4 

Registers on Return: 

CH: Century (BCD) 

CL: Year (BCD) 

DH: Month (BCD) 

DL: Day (BCD) 

Memory Affected: None 
Syntax: 

MOV AH,4 ;Specify service 4 

1NT 1Ah ;BIOS date/time interrupt 

Description: This service, which is available only on the IBM Personal Computer 
jyp retrieves the date from the real-time clock. Remember that all values returned are 
in binary coded decimal (BCD) and that you must make allowances for subsequent 
calculations which use these return values. 

Tor instance, if the date isjuly 1,1987, the value returned inCH is 19h, the value 
in CL is 87h. the value in DH is 07h. and the value in DL is 01 h. 
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If the clock is not functioning, the earn flag is set on return; otherwise the carry 
flag is clear. ’ 7 


Set Date of Real-Time Clock (Interrupt lAh, service 5) 

Category: Date/time services 
Registers on Entry: 

AH: 5 

CH: Century (BCD. 19 or 20) 

CL: Year (BCD) 

DH: Month (BCD) 

DL: Day (BCD) 

Registers on Return: Unchanged 

Memory Affected: None 


Syntax: 


MOV 

MOV 

MOV 

MOV 

INT 


CX,1986h 
DH,12h 
DL,25h 
AH,5 
1Ah 


;Year in BCD 
;December (BCD) 

;Day in BCD 

;Specify service 5 

•BIOS date/time interrupt 


Description: This service, which is available only on the IBM Personal Computer 

T, sets the date of the real-time dock. Remember that ail values used by this service 
should be in binary coded decimal (BCD). 7 

Because no range checking is performed on the registers for this service all 
range checking should be performed by the user program. 


Set Alarm (Interrupt lAh, service 6) 

Category: Date/time services 
Registers on Entry: 


AH: 

CH: 

CL: 

DH: 


6 

Hours (BCD) 
Minutes (BCD) 
Seconds (BCD) 
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Registers on Return: Unchanged 
Memory Affected: None 


Syntax: 


MOV 

CH,01h 

;1 hour 

MOV 

CL,30h 

;30 minutes (BCD) 

MOV 

DH, 0 

;0 seconds 

MOV 

AH,6 

;Specify service 6 

INT 

IAh 

;BI0S date/time interrupt 


Description: This service, which is available only on the IBM Personal Computer 
AT, sets the BIOS alarm function. Remember that all values used by this service are 
expected tc be in binary coded decimal (BCD). The time specified in the registers 
(CH, CL, DH) is the elapsed time before the alarm will occur. In the preceding syntax 
example, the alarm will occur 1 hour, 30 minutes, 0 seconds from the time the service 
is invoked. 

The BIOS alarm function simply generates an interrupt signal after the 
appropriate period of time has elapsed. The address of the routine you want to 
perform should be vectored to Interrupt 4Ah. 

Because no range checking is performed on the registers for this service, all 
range checking should be performed by the user program. 

If the clock is not functioning or if the alarm is already enabled, the carry flag 
is set on return; otherwise, the carry flag is clear. To reset the alarm to another time, 
you must first disable the alarm by invoking service 1A/7; then reset the alarm. 



Disable Alarm (Interrupt lAh, service 7) 

Category: Date/time services 
Registers on Entry: 

AH: 7 

Registers on Return: Unchanged 
Memory Affected: None 
Syntax: 

MOV AH,7 ;Specify service 7 

INT iAh ;BI0S date/time interrupt 
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Description: This service, which is available only on the IBM Personal Computer 
AT, disables an alarm interrupt enabled through service 1A/6. This service must be 
called before the alarm can be reset. 


Read Alarm (Interrupt lAh, service 9) 

Category: Date/time services 
Registers on Entry: 

AH. 9 

Registers on Return: 

CH: BCD hours 

CL: BCD minutes 

DH: BCD seconds 

DL: Alarm status: 

00 = Not enabled 

01 = Enabled, no power on 

02 - Enabled, will power system on when alarm triggers 
Memory Affected: None 
Syntax: 

MOV AH,9 ;Specify service 9 

INT lAh ;BI0S date/tine interrupt 

Description: This service, which is available only on the PC Convertible and the 

PS/2 Model30, reports the setting and sums of the alarm interrupt enabled through 
service 1A/6. 


Get Day Count (Interrupt lAh, service OAh) 

Category: Date/time services 
Registers on Entry: 

AH: OAh 

Registers on Return: 

CX; Total count of days since 01/01/80 
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Memory Affected: None 
Syntax: 

MOV AH,OAh ;Specify service OAh 

INT 1Ah ;BIOS date/time interrupt 

Description: This service, which is available only on the PC XT with BIOS dated 
01/10/86 or later and on the PS/2 line, reports the number of days that have elapsed 
since January 1, 1980 (the internal storage format for the date /unctions). 


Set Day Count (Interrupt lAh, service OBh) 

Category: Date/time services 
Registers on Entry: 

AH. OBh 

CX: Total count of days since 01/01/80 

Registers on Return: Not significant 
Memory Affected: None 
Syntax: 

MOV AH,OBh ;Specify service OAh 

MOV CX,1761 ;day count for Jan. 1 , 1984 

INT 1 Ah ;BI0S date/time interrupt 

Description: This service, which is available only on the PC XT with BIOS da ted 
01/10/86 or later and on the PS/2 line , sets into memory the value in CX as the 
number of days that have elapsed since January 1,1980 (the internal storage format 
for the date functions). 


Control-Break Handler (Interrupt lBh) 

Category: Custom service 
Registers on Entry: Not known 
Registers on Return: Unchanged 
Memory Affected: None 
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Description: This service is called automatically from INT 09h if the Ctrl-Break 
ke^trokc combination is detected and response is cabled. DOS „ 

wan!^ocontroTaUbreak^ ' ha ' ““ " m “ Ch «* “ * Ctrl-C im^p” 

this interruot to processm * ln >’ our Program, you can change the service for 

'° on ' of y°“f °wn choosing. If you do, however, be sure to save the 
onginal address and restore it before your program finishes. 
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H ^ *? acronym for Disk Operating System, can apply to either MS-DOS 
(distributed by Microsoft) or PC DOS (distributed by IBM). Because both 
operaung systems are effectively the same, with the same assembly language 
function calls available through both, this book refers to either dialect as DOS. 

DOS, like BIOS, contains a series of functions that is accessible to outside 
programs. You invoke these functions (callable subroutines) through the use of 
software interrupts, which arc generated through the I NT assembly language 
instruction. INT causes the microprocessor to use an address from an interrupt table 
in low memory as the address for this special type of subroutine. 

Specifically, INT pushes the flags register on the stack and then resets the 
interrupt and trap flags. The full return address (CS:IP) is placed on the stack, at 
which point the desired interrupt vector (address) is retrieved from the interrupt 
table and placed in CS:IP. Execution of the interrupt then continues until an iret 
instruction is encountered. At this point, the return address is popped from the stack 
and placed in CS:IP. The flags register is then restored from the stack, and program 
execution continues from the point at which the interrupt was invoked. 

Notice that the interrupt address is fetched from the interrupt table, based 

on the number of the interrupt being invoked. The full syntax for calling an inter- 
rupt is 

INT XX , 

where xx is replaced by the number of the appropriate interrupt. 
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Chapter 20 detailed many BIOS functions that arc callable 
interrupts. This chapter provides the same kind of information for DOS sen »ces. Ai 

the documented DOS sen-ices are included in this chapter; lhe U "^^^n official 
are not. Undocumented DOS services are the ones that are not pubhsfc .ed «n otticrai 

Microsoft or IBM technical documents They usually ar 'J‘* COV " C y „ ment over 
programmers painstakingly disassembling DOS. Since there is gr 
whaTsome of these unofficial services do. they are not covered here. Many othe 

books that cover them are available. 


The DOS Service Categories 

H cervices offered by DOS can be divided into several broad 
categorieJ"Sly specified by the function s task classification. The DOS function 

categories include 

□ I/O sen-ices 

□ Printer senices 
Q Disksen-ices 

□ System services 

□ Network services 

□ Date/time services 

Some of these categories may look familiar to readers who have referred to 
Chapter 20 Although the categories are similar to the BIOS services, the operations 
may vary considerably. The largest categories of DOS services are, understandably, 
thedisk and system services. Table 21.1 lists the DOS services covered in this 
chapter, sorted by category. 

The services are arranged in ascending numerical order. Each service can be 
identified by the primarv interrupt number and an individual service number which 
is specified by the contents of the AH register when the interrupt is invoked. In this 
notation scheme, any DOS service can be denoted by a hexadecimal number pair. 
II/SS, where II is the interrupt number and SS is the serv ice number. For instance, the 
service used to remove a subdirectory, service 21/3A, has an interrupt number o 
21h, and a service number (specified through register AH) of 3Ah. 

Other services may be specified as II/SS/FF, where the appended FF indicates 
the function number. For instance, the service used to read from a block device, 
sei^ice 21/44/04, has an interrupt number of 21h, a service number (specifie 
ihrougi.agister AH) of 44h, and a function number (specified through register AU 
of 04h. 
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Table 21.1. DOS services list, sorted by categoiy. 

I/O Sendees 


7 

ss 

Service Same 

21 

01 

Character Input with Echo 

21 

02 

Output Character 

21 

03* 

Auxiliary Input 

21 

04 

Auxiliary Output 

21 

06 

Direct Console I/O 

21 

07 

Direct Character Input without Echo 

21 

08 

Character Input without Echo 

21 

09 

Output Character String 

21 

0A 

Buffered Input 

21 

OB 

Check for Character Waiting 

21 

OC 

Clear Buffer and Get Input 



Printer Sendees 

U 

ss 

Service Name 

21 

05 

Printer Output 



Disk Sendees 

n 

55 

Sendee Name 

21 

OD 

Reset Disk 

21 

OE 

Set Default Drive 

21 

OF 

Open File, Using FCB 

21 

10 

Close File, Using FCB 

21 

11 

Search for First File-name Match, Using FCB 

21 

12 

Search for Next File-name Match, Using FCB 

21 

13 

Delete File, Using FCB 

21 

14 

Sequential Read, Using FCB 

21 

15 

Sequential Write. Using FCB 

21 

16 

Create File, Using FCB 

21 

17 

Rename File, Using FCB 

21 

19 

Get Current Drive 


continues 
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Table 21.1. 

continued 


11 

SS 

Service Name 

21 

1A 

Set Disk Transfer Area (DTA) 

21 

IB 

Get FAT Information for Default Drive 

21 

1C 

Get FAT Information for Drive 

21 

IF 

Get Default Disk Parameter Block 

21 

21 

Random Read, Using FCB 

21 

22 

Random Write, Using FCB 

21 

23 

Get File Size, Using FCB 

21 

24 

Set Random Record Field in FCB 

21 

27 

Read Random Record(s), Using FCB 

21 

28 

Write Random Record(s), Using FCB 

21 

29 

Parse File Name, Using FCB 

21 

2E 

Set Verify Flag 

21 

2F 

Get Disk Transfer Area 

21 

32 

Get Disk Parameter Block 

21 

36 

Get Disk Free Space 

21 

39 

Create Subdirectory 

21 

3A 

Remove Subdirectory 

21 

3B 

Set Directory 

21 

3C 

Create File 

21 

3D 

Open File 

21 

3E 

Close File 

21 

3F 

Read File 

21 

40 

Write File 

21 

41 

Delete File 

21 

42 

Move File Pointer 

21 

43 

Get/Set File Attributes 

21 

45 

Duplicate File Handle 

21 

46 

Force Handle Duplication 

21 

47 

Get Directory Path 

21 


Search for First File-Name Match 

21 

4F 

Search for Next File-Name Match 

21 

56 

Rename File 
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21 

21 

21 

21 

21 

21 

25 

26 


57 

5A 

5B 

5C 

68 

6C 


Get/Set File Date and Time 
Create Temporary File 
Create File 
File Access Contri 1 
Flush Buffer 

Extended Open/Create File 
Absolute Disk Read 
Absolute Disk Write 

System Services 


n 

ss 

FF 

Service Name 

20 



Terminate Program 

21 

00 


Terminate Program 

21 

25 


Set Interrupt Vector 

21 

21 

26 

1A 


Create Program Segment Prefix (PSP) 

Sf A 

DU 


Get DOS Version Number 

21 

31 


Terminate and Stay Resident 

21 

33 

00 

Get Ctrl-BreaJc Flag 

21 

33 

01 

Set Ctrl-Break Flag 

21 

33 

05 

Get Boot Drive Code 

21 

33 

06 

Get DOS Version Number 

21 

34 


Get Address of InDOS Flag 

21 

35 


Get Interrupt Vc. ;or 

21 

38 


Get/Set Countr. Dependent Infor¬ 




mation 

21 

44 

00 

Get Device Information 

21 

44 

01 

Set Device Information 

21 

44 

02 

Character Device Read 

21 

44 

03 

Character Device Write 

21 

44 

04 

Block Device Read 

21 

44 

05 

Block Device Write 

21 

44 

06 

Get Input Status 

21 

44 

07 

Get Output Status 


continues 
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MM 

21 

44 

08 

21 

44 

OB 

21 

44 

OC 

21 

44 

OD 

21 

44 

OE 

21 

44 

OF 

21 

44 

10 

21 

44 

11 

21 

48 


21 

49 


21 

4A 


21 

4B 

00 

21 

4B 

03 

21 

4B 

.05 

21 

4C 


21 

4D 


21 

50 


21 

51 


21 

54 


21 

58 

00 

21 

58 

01 

21 

58 

02 

21 

58 

03 

21 

59 


21 

5D 

0A 

21 

62 


21 

65 

01 

% 

21 

65 

02 

21 

65 

04 

21 

65 

05 

-> i 

65 

06 


Block Device Changeable? 

Set Sharing Retry Count 

Handle Generic Code-Page Switching 

Generic lOCTL Block Device Request 

Get Logical Device Map 

Set Logical Device Map 

Query' Handle 

Query Drive 

Allocate Memory' 

Free Allocated Memory 
Change Memory-Block Allocation 
Load Program 
Load Overlay 
Set Execution Sute 
f Process Terminate 
Get Return Code of a Subprocess 
Set PSP Address 
Get PSP Address 
Get Verify Setting 
Get Allocation Strategy 
Set Allocation Strategy 
Get High-Memory Link Status 
Set High-Memory’ Link Status 
Get Extended Error Information 
Set Extended Error Values 
Get Program Segment Prefix (PSP) 
Address 

Get Extended Country Information 
Get Uppercase Table 
Get Filename Uppercase Table 
Get Invalid Filename Character Table 
Get Sort Sequence Table 
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21 

65 

07 

Get Doublt-Byte Character Set 

2! 

65 

20 

Convert Character 

21 

65 

21 

Convert String 

21 

65 

22 

Convert ASCIIZ String 

21 

66 


Get/Set Global Code Page 

21 

67 


Change Handle Count 

27 



Terminate and Stay Resident 

2F 



Multiplex Interrupt 




Network Services 

// 

SS 

FF 

Service Name 

21 

44 

09 

Logical Device Local He mote Detenni- 




nation 

21 

44 

0A 

Handle Local Remote De termination 

21 

5E 

00 

Get Machine Name 

21 

5E 

02 

Set Printer Setup 

21 

5E 

03 

Get Printer Setup 

21 

5F 

02 

Get Redirection List Entry 

21 

5F 

03 

Redirect Device 

21 

5F 

04 

Cancel Redirection 


. 


DatefTime Services 

U 

SS 


Service Name 

21 

2A 


Get System Date 

21 

2B 


Set System Date 

21 

2C 


Get System Time 

21 

2D 


Set Time 


The number of DOS services available to you depends on wh>ch version of 
DOS you are using The services explained in this chapter work with L>( :•$ versions 
up through 5 0 Earlier versions of DOS may not include all the functions detailed, 
although 1 have tried to indicate these cases in the individual service descriptions 
If you have questions, consult your DOS technical manual 
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The rest of this chapter forms a convenient reference section. Each DOS service 
,S described in detail in an organized manner The following information is provided 

for each service; 

3 Service name. This name is based on the DOS function names selected by 
IBM or Microsoft and listed in various technical documemat.on Whe 
appropriate, the name has been modified or expanded to reflect mo 
accurately the purpose of the service. 

□ Service category. The general classification of the service, as previously 

listed. 

□ Registers on entry. DOS service parameters generally are passed tliroug 
registers. The expected register settings are given here. 

□ Registers on return. For proper operation of software, you must kno * 

3 hmv registers are affected by interrupts. Frequently. DOS functions return 

values through registers. Such information is detailed here. 

□ Memory area* affected. Some DOS functions modify memory based on 
the ucsired service. Any affected memory is given. 

□ Syntax for calling. A coding section shows the proper method for calling 
the interrupt. 

□ Description. The purpose, benefits, and special considerations of the 
service are given in this section. 

Table 21.2 lists the interrupts and services detailed in this chapter, sorter in 
ascending numeric order. 

Table 21.2. DOS sendees, listed tn numeric order. 

Service Name 


II 


SS 


FF 


20 . 


Terminate Program 

21 

00 

Terminate Program 

21 

01 

Character Input with Echo 

21 

02 

Output Character 

21 

03 

Auxiliary Input 

21 

04 

Auxiliary Output 

21 

05 

Printer Output 

21 

06 

Direct Console I/O 
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II 

SS 

FF 

Service Nome 

21 

07 


Direct Character input w ithout Echo 

21 

08 


Character Input without Echo 

21 

09 


Output Character String 

21 

0A 


Buffered Input 

21 

OB 


Check for Character Waiting 

21 

OC 


Clear Buffer and Get Input 

21 

OD 


Reset Disk 

21 

OE 


Set Default Drive 

21 

OF 


Open File, Using FCB 

21 

10 


Close File. Using FCB 

21 

11 


Search for First File-Name Match. Using 
FCB 

21 

12 


Search for Next File-Name Match, Using 
FCB 

21 

13 


Delete File. Using FCB 

21 

14 


Sequential Read. Using FCB 

21 

15 


Sequential Write, Using FCB 

21 

16 


Create File. Using FCB 

21 

17 


Rename File, Using FCB 

21 

19 


Get Current Drive 

21 

1A 


Set Disk Transfer Area ^DTA) 

21 

IB 


Get FAT Information for Default Drive 

21 

1C 


Get FAT Information for Dri.e 

21 

IF 


Get Default Disk r arameter block 

21 

21 


Random Read, Using FCB 

21 

22 


Random Write. Using FCB 

21 

23 


Get File Sue. Using FCB 

21 

24 


Set Random Record Field in FCb 

21 

25 


Set Interrupt Vector 

21 

26 


Create Program Segment Prefix (PSP) 

21 

27 


Read Random Record(s), Using FCB 

21 

28 


Write Random Rccord(s), Using FCB 

21 

29 


Parse File Name. Using FCB 


continues 
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continued 

- *" 1 ~ 


11 

SS 

FF 

Service Name 

21 

2A 


Get System Date 

21 

2B 


Set System Date 

21 

2C 


Get System Time 

21 

2D 


Set Time 

21 

2E 


Set Verify Flag 

21 

2F 


Get Disk Transfer Area 

21 

30 


Get DOS Version Number 

21 

31 


Terminate and Stay Resident 

21 

32 


Get Disk Parameter Block 

21 

33 

00 

Get Ctrl-Break Flag 

21 

33 

01 

Set Ctrl-Break Flag 

21 

3 \ 

05 

Get Boor Drive Code 

21 

33 

00 

Get DOS Version Number 

21 

34 


Get Address cf InDOS Flag 

21 

35 

/ 

Get Interrupt Vector 

21 

36 


Get Disk Free Space 

21 

38 


Get/Set Country-Dependent Infor¬ 
mation 

21 

39 


Create Subdirectory 

21 

3A 


Remove Subdirectory 

21 

3B 


Set Directory 

21 

3C 


Create File 

21 

3D 


Open File 

21 

3E 


Close File 

21 

3F 


Read File 

21 

40 


>X'rite File 

21 

41 


Delete File 

21 

42 


Move File Pointer 

21 

43 


Get/Ser Hie Attributes 

21 

44 

00 

Get Device Information 

21 

§4 

01 

Set Device Information 

21 

44 

02 

Character Device Head 
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II 

SS 

FF 

Service A 'time 

21 

44 

03 

Character Device Write 

21 

44 

04 

Block Device Head 

21 

44 

05 

block Device Write 

21 

44 

06 

Get Input Status 

21 

44 

07 

Get Output Status 

21 

44 

08 

Block Device Changeable? 

21 

44 

09 

Logical Device Local/Rcmotc Determi* 
nation 

21 

44 

0A 

Handle Local/Remote Determination 

21 

44 

OB 

Set Sharing Retry Count 

21 

44 

OC 

Handle Generic Code-Page Switching 

21 

44 

OD 

Generic IOCTL Block-Device Request 

21 

4*» 

OE 

Get Logical Device Map 

21 

44 

OF 

Set Logical Device Map 

21 

44 

10 

Query Handle 

21 

4i 

11 

Query Drive 

21 

45 


Duplicate File Handle 

21 

46 


Force Handle Duplication 

21 

47 


Get Directory Path 

21 

48 


Allocate Memory 

21 

49 


Free Allocated Memory 

21 

4A 


Change Memory-Block Allocation 

21 

4B 

00 

Load Program 

21 

4B 

03 

Load Overlay 

21 

4B 

05 

Set Execution State 

21 

4C 


Process Terminate 

21 

4D 


Get Return Code of a Subprocess 

21 

4E 


Search for First File-Name Match 

21 

4F 


Search for Next File-Name Match 

21 

50 


Set PSt* Address 

21 

51 


Get PSP Address 

21 

54 


Get Verify Setting 

21 

56 


Rename File 

continues 
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Table 21.2. continued 


II 

SS 

FF 

Service Name 

21 

57 


Get/Set File Date and Time 

21 

58 

00 

Get Allocation Strategy 

21 

58 

01 

Set Allocation Strategy 

21 

58 

02 

Get High-Memory Link Status 

21 

58 

03 

Set High-Memory Link Status 

21 

59 


Get Extended Error Information 

21 

5A 


Create Temporary File 

21 

5B 


Create File 

21 

5C 


• File Access Control 

21 

5D 

0A 

Set Extended Error Values 

21 

5E 

00 

Get Machine Name 

21 

5E 

02 

Set Printer Setup 

. 21 

5E 

03 

Get Printer Setup 

21 

5F 

02 

Get Redirection List Entry 

21 

5F 

03 

Redirect Device 

21 

5F 

04 

Cancel Redirection 

21 

62 


Get Program Segment Prefix (PSP) 

Address 

21 

65 

01 

Get Extended Country Information 

21 

65 

02 

Get Uppercase Table 

21 

65 

04 

Get Filename Uppercase Table 

21 

65 

05 

Get Invalid Filename Character Table 

21 

65 

06 

Get Son Sequence Table 

21 

65 

07 

Get Double-Byte Character Set 

21 

65 

20 

Convert Character 

21 

65 

21 

Convert String 

21 

65 

22 

Convert ASC11Z String 

21 

66 


Get/Set Global Code Page 

21 

67 


Change Handle Count 

21 

68 


Flush Buffer 

21 

6C 


Extended Open/Crcate F.le 

22 



Terminate Address 
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23 

Ctrl-Dreak Handler Address 

24 r 

Critical Error Handler Address 

25 

Absolute Disk Read 

26 

Absolute Disk Write 

27 

Terminate and Stay Resident 

2F 

Multiplex Interrupt 



Terminate Program (Interrupt 20h) 

Category: System services 

Registers on Entry: Not significant 

Registers on Return: Unspecified (does not return) 

Memory Affected: None 
Syntax: 

INT 20h ;Terminate program 

Description: You can use this interrupt to terminate a program and return control 
to DOS. Internally, DOS restores several critical vector addresses (Ctrl-C and critical- 
error handlers), flushes the file buffers, and transfers control to the termination 
handler address. This interrupt is equivalent to service 21/0. 

This service does not allow you to pass a return code to DOS or to a parent 
program. For that capability, see services 21/31 and 21/4C. 

Terminate Program (Interrupt 21h, service 0) 

Category: System services 

Registers on Entry: 

AH: 0 

CS: Segment address of program s PSP 

Registers on Return: Unspecified (does not return) 

Memory Affected: None 
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Syntax: 

MOV AH,0 

INT '21h ;OOS services interrupt 

Description: You can use this service to terminate a program and return control to 
DOS. Internally, DOS restores several critical vector addresses (Ctrl-C and critical- 
error handlers), flushes the file buffers, and transfers control to the termination 
handler address. This service is equivalent to issuing an INT 20h. 

AH is the only functional register you need to load before calling this service. 
Because CS, in all likelihood, will not have changed since the program began, CS 
should already be set to the proper value. 

1 his service does not allow you to pass a return code to DOS or to a parent 
program For that capability, see services 21/31 and 21/4C. 


Character Input with Echo (Interrupt 21h, service 1) 

Category: I/O services 
Registers on Entry: 

AH: 1 

Registers on Return: 

AL: Character 

Memory Affected: The appropriate areas of video memory arc altered to reflect the 
displayed (echoed) character. 

Syntax: 

MOV AH,1 

INT 2lh ;DOS services interrupt 

Description: Originally, this sen-ice was designed to fetch a character from the 

keyboard and display that character on the video monitor Intermediate versions of 

DOS however, have modified this service so that I/O redirection is possible. If the 

standard input device or console has been redirected, this sen ice fetches a character 

from the specified device. Regardless of the device, the character is echoed to the 
video monitor. 


tor redirection I**** SCrV '£ c waits a chavacter to be returned by the keyboard 

routines in thai onl CV,CC) ’ thc senicc diff ers significantly from the BIOS kevboard 

is geneied bvile is rcrurned i"AL. Ifan extended ASCII code 

e > ar (such as codes generated by the function keys or 
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cursor-control keys), interrupt 2 lh. service I returns a zero 
service again, it returns the scan code in Al¬ 


in AL. If you invoke the 


Output Character (Interrupt 21h, service 2) 

Category’: I/O services 
Registers on Entry: 

AH: 2 

DL: Character (ASCII value) 

Registers on Return: Unchanged 

Memory Affected: If 1.0 has no. been redirected, .he appropria.e areas of video 
memory are altered to reflect the displayed character. 


;Output an asterisk 
;DOS services interrupt 


Syntax: 

MOV DL,**' 

MOV AH,2 

INT 21h 

D e S eHpr i o n = 0 ri g inafb..hi SS erv^ 5 ^ — 

^^^•^S^viee has been redirected. ~ 
service sends a character to the specified device. 


Auxiliar y Input (Interrupt 21h, service 3) 

Category: I/O services 
Registers on Entry: 

All 3 

Registers on Return: 

AL. Character 

Memory Affected: None 


Syntax: 

MOV AH,3 
INT 21h 


;DOS services interrupt 


Scanned by CamScanner 



Description: This service returns a character from the standard auxiliary device 
which, if not redirected, is set to be COM1:. 

This service is a poor way to read the communications port. More precise and 
error-free communication is possible through the BIOS communications functions 
(services 14/0-14/2) or. better yet. through a custom interrupt-driven communica- 
tions interface. (Such an interface, however, is beyond the scope of this book.) 


Auxiliary Output (Interrupt 21h, service 4 ) 

Category: 1C) services 
Registers on Entry: 

AH: 4 

DL: Character (ASCII value) 

Registers on Return: Unchanged 
Memory Affected: None 


Syntax: 

MOV DL, ‘ 
MOV AH,4 
INT 21h 


;Output an underscore 
;DOS services interrupt 


Description: This service sends a character 
if not redirected, is set to COM1:. 


to the standard auxiliary' device, which 


Th.s serv.ce is a poor way ,o comrol .he con.munica.ions po.r More precise 
and error-free communica,ion is possible through the BIOS communication 
functions (services 14/0-14/2). or better yet through a custom intemipt.drtven 
communications Interface. (Such an interface, however, is beyond the sco£e of dS 



Printer Output (Interrupt 21h, service 5) 

Category: Printer services 
Registers on Entry: 

AH: 5 

DL: Character (ASCII value) 
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HcjihUTs on Return. I rn.lt.mm-d 
Memon Affected: None 
Syntax: 

MOV ' Ot ;Hnnt an underscore 

MOV AH, 5 

INT 2ih ;D0S services interrupt 

Description: This senice sends a character to the standard list device. Unless 
redirected, this device is LPT1:. 


Direct Console I/O (Interrupt 21h, service 6) 

Category: I/O services 
Registers on Entry: 

AH : v 6 

DL: Character (ASCII value) or input flag 

Registers on Return: 

AL: Input character 

Memory Affected: If the service is outputting a character to the video monitor, the 
appropriate video memory areas are changed to reflect the character being dis- 


played. 




Syntax: 

INP_LOOP: 

MOV 

DL.OFFh 

;Want to input 

GOT CHAR: 

MOV 

INT 

JZ 

CMP 

JNE 

MOV 

iiMP 

MOV 

AH,6 

2lh 

NO_CHAR 

AL, 0 

G0T_CHAR 
EXTEND_FLAG,1 
INPJ.00P 

CHAR,AL 

;DOS services interrupt 
;No character ready 
;Was it extended ASCII? 

;No, treat as character 
;Yes, so set appropriately 
;Get scan code 
;Store character 


Description: You can use this sen ice for character input or output, depending on 
the contents of DL. If DL is a value between 0 and 25-1 (OFEh). the contents of DL are 
sent to the console (unless redirected, the video screen). If DLcontains 255 (OFFh). 
input is fetched from the console (unless redirected, the keyboard). 
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whcn > ou , « r< l utsl in P ul through this sc nice, the zero (lag is set on return 
indicate the presence of a character Zero in Al. means th it a key generating a 

extended ASCII code has been pressed, and this service should be invoked air.m r!! 
retrieve the scan code. *' un to 


Direct Character Input without Echo (Interrupt 21h 
service 7) * 

Category: I/O services 


Registers on Entry: 

AH: 7 

Registers on Return: 
*L: Character 


Memory .Affected: Nont 
Syntax: 


MOV 
I NT 


AH ,7 

2lh 


;i)OS services interrupt 


De5 cr .p"°„ : Originally, this, service was designed simply to fetch a character from 

hLf/O^H erm , ™ S Qf DOS ’ however ' ha « htodified this service so 

that I/O red,rect.cn is possible. If the standard input device or console haT£™ 

redirected, this service fetches a character from the specified device. 

Even though this serv.ee waits for a character to be relumed by the keyboard 
(or redirected I/O device), the service differs significantly from the BIOS k^ard 

an extended S 

control keys,, this service returns a 0 in AL. A second 



Character Input without Echo (Interrupt 21h, service 8) 

Category: I/O services 
Registers on Entry: 

All: 8 
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Registers on Return: 

AL: Character 

Memory Affected: None 
* Syntax: 

MOV AH, 8 

.INT 21h ;DOS services interrupt 

Description: Originally, this sen ice was designed simply to fetch a character from 
the keyboard Intermediate versions of DOS. however, have modified this senice so 
that 1.0 redirection is posable If the standard input device or console has been 
redirected, this sen ice letches a character from the specified device. 

Even though this sen ice waits for a character to he returned bv the keyboard 
(or redirected I O device), the sen ice differs significantly Irom the BIOS keyboard 
routines in that only one character code is returned in AL. If the keyboard generates 
an extended ASCII code (such as codes generated hv the function keys or cursor- 
control keys), this senice returns j 0 in AL. A second invocation returns the scan 
code in AL. 

This sen ice differs from 21 T in that it performs some interpretation on the 
characters received. For instance, if Ctrl-C and Ctrl-Break are received, they are 
translated and acted on by this sen ice. 


Output Character String (Interrupt 21h, senice 9) 

Catego*-v. i O sendees 

Register.; on Entry: 

AH: 9 

DX: Offset address of string 

DS: Segment address of string 

Registers on Return: Unchanged 

Memory .Affected: If output is directed to the video display, the contents of the 
video memory buffers are changed appropriately to reflect the characters displayed. 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

MOV 

OX,OFFSET MSG_1 

;Offset address of string 

MOV 

AH,9 


INT 

2lh 

;DOS services interrupt 
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Description: This service displays (or outputs) a string on the standard output 
device. It 1.0 has been redirected, the string is sent to the specified device. 

Each character of the string at DS:DX—up to (but not including) the first 
occurrence of a dollar sign (ASCII 36)—is displayed by this service. Because of this 
strange convention (a carry-over from CP/M), you cannot display the dollar sign when 
you are using this service. 


Buffered Input (Interrupt 21h, service OAh) . 

Category: 1.0 sen-ices 
Registers on Entry: 

AH: OAh 

DX: Offset address of buffer 

DS; Segment address of buffer 

Registers on Return: Unchanged 

Memory Affected: The memory area beginning at DS-.DX is overlaid with characters 
input from the standard input device. 


Syntax: 


PUSH 

CS 

,Cooe segment and 

POP 

DS 

; data, segment are same 

MOV 

DX,OFFSET BUFFER 

;Offset address of buffer 

MOV 

AH,OAh 


I NT 

21h 

;00S services interrupt 


Description: This sen-ice allows the input of a specified number of characters from 
the standard input device. You can change the device, which originally is the 
l eyboard, through LO redirection. 

The input characters are stored at the buffer specified by DS:DX. The value of 
the first byte of this buffer must indicate the maximum number of characters the 
buffer can contain. DOS sets the value of the second byte to indicate the number of 
characters this service returns. Therefore, if your maximum input length is 80 
characters, you should set aside 82 bytes for the buffer. 

This service does not return until you press Enter. If the buffer is filled before 
the service detects the carriage return, the extra characters are ignored and the bell 
sounds with each extra keypress. Remember that each extended ASCII character 
(function keys, and so on) occupies two bytes in the buffer area. 
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Check for Character Waiting (interrupt 21h, .service' OBh) 

Category: I/O services 


Registers on Entry: 

AH: OBh 

Registers cn Return: 

AL: Waiting flag 

Memory Affected: None 
Syntax: 


KEYJ.OOP: 


MOV 
I NT 
CMP 
JE 


AH,OBh 
21h 
AL.O 
KEY LOOP 


;DOS services interrupt 
;Was there a keypress? 

I No, continue to wait 


k" : TI ?' S scrvice sim P'y checks the status of the standard input device 
(usually the keyboard) to determine whether a character is available for , 

chancer is available. At equals FFh. If no character is anUable .L cquaL o 


Clear Buffer and Get Input (Interrupt 21h, service OCh) 

Category: I/O services 
Registers on Entry: 

AH: OCh 

AL: Desired input service 

DX. Offset address of buffer 

DS: Segment address of buffer , 

Registers on Return: 

A*-: Character (ASCII value) 

Memory Affected: If At is loaded with OAh, the memorv area beuinninc at DS nx 
» n<rtf^ hChlraC,CRinPU,from,heS “ ndartinpu,device 0, hF~ise., 


, memory 


595 
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Syntax: 

PUSH 
POP 
MOV 
MOV 
MOV 
IfJT 


CS 

DS 

DX, OFFSET BUFFER 
AL,0Ah 
AH.ocn 
2\t\ 


;Cooe segment and 
• data segment are same 
;Offset address of Duffer 
;V.'ant input service OAh 

;OOS services interrupt 


- H. AH. into .AL. After ,hc npe-ahead buffer » c.eared. .he 

spcuiicd service is invoked. 

if Al is set to 0\h. DS:DX must point to a buffer that is constructed in the 
fashion described under service 21/A. If AL is sei to one of the other semces. t e 
contents- of DS DX are not significant. 

UAL is set to 1.6,7. or 8. on return ALcontains.he ASCII valueof thecharac.er 
fetched The other characteristics of these DOS semces are maintained. Please refer 
to the appropriate service descriptions for additional information. 



Reset Disk (Interrupt 21h, service ODh) 


Category: Disk services 
Registers on Entry: 

AH: ODh 

Registers on Return: Unchanged 
Memory Affected: None 


Syntax: 

MOV AH,ODh 

j NT 2ih ;DOS services interrupt 

Description: This service flushes the DOS disk buffers. If a DOS file buffer contains 
information tobc written to a disk file, that information is written to disk. The service 
does not close the files. 

This service does not change the default drive and has no physical effect on the 
disk drives or their controllers. 
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Set Default Drive (Interrupt 21h, service OHh) 

Category; Disk services 

Registers on Kutry: 

AH: OP.h 

DL: Drive wanted 

Registers on Return: 

AL: Logical drives 

Memory /Affected: None 

Syntax: 


MOV 

DL ,2 

; Set 

for drive C: 

MOV 

AH,0Eh 



I NT 

21h 

;D0S 

services interrupt 


Description: This service has rwo purposes: (1) to set the default drive designation 
by specifying the desired drive in DL. where 0 = A, 1 = B. 2 = C. etc.: (2) to find out how 
many logical disk drives are connected to the computer. 

Logical disk drives include RAM disks, disk emulators, and multisegmented 
hard disk drives. For instance, if you have rwo floppy drives (A and B ), a 40M hard 
disk partitioned to rwo disks (C and D;). and a KA.M disk (E:). this service returns 
a value of 5 in AL even though only three physical drives are connected to the 
computer. 

Clearly, knowing how many logical drives are connected to a computer 
without actually changing the default disk drive may be beneficial. You can get this 
information by determining the current default drive (through service 21/19) and 
then using that information to call this service. The following code segment 
performs this task 


MOV 

AH,i9n 


I NT 

21 h 

;D0S services interrupt 

MOV 

CUR_DRIVE,AL 

;Store current drive (0 't) 

MOV 

OL.AL 

;Set for default drive 

MOV 

AH.CEh 


INT 

2in 

;D0S services interrupt 

MOV 

NUM_0RIVE3,AL 

;Store number of drives 


For more information about service 21/19. rcfci to the description for that 
service. 


Scanned by CamScanner 




598 


Pan IV: Ucferelite 


Open File, Using FCB (Interrupt 21 h, service OFh) 

Category*: Disk services 
Registers on Entry: 

All: OFh 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

Al.: Status byte 

Memory AfTceted: If the service opens the file successfully. DOS fills in the FCB area 
specified by DS:l)X to reflect the status of the file opened. 


Syntax: 


PUSH 

cs 

{Code segment and 

POP 

OS 

; data segment are same 

MOV 

DX,OFFSET FCB_ 1 

'.Offset address of FCB 

MOV 

AH,OFh 


INT 

2 lh 

;DOS services interrupt 


Description: This service opens a disk file. b. ed on a file control block, -or FCB. 
'The FCB is a block of information that is set initially by the programmer and then 
completed by DOS. The FCB comists of bytes constructed in the following 


manner: 




FCB_PRE 

DB 

0FFh 

Extension flag 


OB 

5 DUP(O) 

;Unused 


DB 

00 

;File attribute 

FCB_1 

DB 

00 

;Set for default drive 

FILE_ROOT 

OB 

•FILENAME* 

{File name root 

FIL£_EXT 

DB 

• EXT ’ 

;File name extension 

BLOCK_NUM 

DW 

0000 

{Current block number 

REC_SIZE 

OW 

0000 

{Record size 

FILE_SIZE 

DO 

00000000 

;File size 

FILE_OATE 

OW 

0000 

;File date 

FILE_TIME 

DW 

0000 

;File time 


DB 

6 DUP(0) 

;00S work area 

REC_NUM 

OB 

00 

{Current record number 

RANDOM_REC 

00 

00000000 

{Random record number 


The offset address of fcb_i is the address you specify in DS:DX when you 
invoke this service. If >ou are using an extended FCB. use the offset address of 
FCB_PRE To call this service, the values for FCB_i (the drive designator). FILE_AOOT. 
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and FILE_EXT must he specified. Notice that the drive designator is different from the 
normal method for DOS and BIOS drive designation. 0 ri presents the default drive, 
and 1 — A. 2=13. 3=C. etc. 

If the open operation is .‘uccessful, DOS returns a 0 in Al. and sets FCB_i to 
reflect the drive number (1=A. 2 = B. 3 = C, etc ). DOS also sets block num to 0; 
REC_SIZE to 80h: and FILE_SIZE. FIlE_DATE. and FILE_TIME to the equivalent of the 
directory entry for the file. If the open operation is unsuccessful. DOS returns FFh 
in AL. and the FCB is not filled in. 

Notice that this service allows you to use only FCBs. Because FCB file encoding 
does not allow for path names, any file operations must be performed in the current 
disk subdirectory. With floppy disKS. this limitation may not be a problem, but with 
fixed disks the limitation can be serious. Refer to sen ice 21 3D for a file-opening 
method that does not have this limitation. 


Close File, Using FCB (Interrupt 21h, service lOh) 

Category: Disk services 
Registers on Entry: 

AH: lOh 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

AL: Status byte 

Memory Affected: None 


Syntax: 

PUSH CS 
POP DS 

MOV DX,OFFSET FCB_1 
MOV AH,lOh 
INT 21h 


;Code segment and 
; data segment are same 
;0ffset address of FCB 

;D0S services interrupt 


Description: This service closes a disk file, based on a file control block, or FCB. 
The FCB consists of 44 bytes constructed in the following manner: 


FC8_PRE 

OB 

©FFh 

Extension flag 


06 

S DUP(0) 

;Unused 


OB 

0© 

;File attribute 

FCBl 

08 

00 

;Set for default drive 
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FILE_R00T 

OB 

•FILENAME‘ 

;File name root 

FILE_£XT 

OB 

' EXT ‘ 

;File name extension 

BL0CK_NUM 

OW 

0000 

;Current block numoer 

REC_SIZE 

D'.V 

0000 

;Record size 

FILE.SI2E 

00 

oooecooo 

;File size 

FILE_DATE 

DW 

0000 

;File date 

FILE_TIME 

DW 

0000 

;File time 


OB 

8 DUP(0) 

;D0S work area 

REC_NUM 

DB 

00 

;Current record number 

RANDOM_REC 

DO 

oooooooo 

;Random record number 


The offset address of FCB_i is the address you specify in DS.-DX when you 
invoke this service. If you are using an extended FCB, use the offset address of 
fcb_pre. To call this service, you must specif)' the values for FCB_1 (the drive 
designator). file_R00T, and FliE_EXT. Notice that the drive designator is different 
from the normal method tor DOS and BIOS drive designation In this instance. 0 
represents the default drive, and 1=A. 2=B. 3=C, etc. 


If the close operation is successful. DOS returns a 0 in AL: if the operation is 
unsuccessful. AL contains FFh. 


Notice that this service allows you to use only FCBs. Because FCB file encoding 
does not allow for path names, any file operations must be performed in the current 
disk subdirector)'. With floppy disks, this limitation may not be a problem, but with 
fixed disks the limitation can be serious. (Service 21/3E. another method of closing 
files, docs not have this limitation.) 



Search for First File-Name Match, Using FCB 
(Interrupt 21h, service llh) 

Category: Disk services 
Registers on Entry': 

AH: llh 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

AL: Status byte 


11 r r,k ' n:,m<: ma "- h is l°cat DOS nils in the memon- area spec- 

dos fliers - ;■ pc» r„,*. 

” B 4rca to a,low subsequeht searching with service 21/12. 
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Syntax: 


PUSH 

CS 

-.Code segment and 

POP 

OS 

; data segment are same 

MOV 

OX.OFFSET FCB_1 

;0ffset address of FCB 

MOV 

AH,11h 


INT 

21 h 

;C0S services interrupt 


Description: This service locates a file with a specified name in the current directory 
of a disk drive, based on a tile control block, or FCB. The FCB consists of -»-* b\ies 
constructed in the following manner: 


FCB_PRE 

OB 

OFFh 

;Extension flag 

» 

DB 

5 DUP(0) 

;Unused 

FILE_ATTR 

DB 

00 

;File attribute 

FCB_1 

DB 

00 

;Set for default drive 

FILE_R00T 

OB 

'FILENAME' 

;File name root 

FILE_EXT 

> 

CO 

Q 

' ???' 

;FiJ.e name extension 

BL0CK_NUM 

DW 

0000 

;Current block number 

REC_SIZE 

DW 

0000 

-.Record size 

FILE_SIZE 

DO 

00000000 

;File size 

FILE_DATE 

DW 

0000 

;File date 

FILE_TIME 

DW 

0000 

;File time 


DB 

8 DUP(0) 

;D0S work area 

REC_NUM 

DB 

00 

;Current record number 

RANDOM_REC 

DO 

O00O0OCO 

;Random record number 


The offset address of fcb_i is the address you specify in DS:DX when vou 
invoke this service. If you are using an extended FCB. you should use the offset 
address of FCB_PRE. To call the sen ice. \ou must specifv the values for FC8 i (the 
drive designator). FILE_R00T. and file_ext. Notice that the drive designator is 
different from the normal method for DOS and BIOS drive designation. In this 
instance. 0 represents the default drive, and 1 =A. 2 - B 3 = C. etc. 

One useful feature of this sen-ice is that you can use the question mark (?) as 
a wild card in the file-name specification of the FCB. In the sample FCBranv file 
with the name FILENAME and any extension constitutes a match. 

If you are searching for non-normal files (that is. hidden, system, etc ), you 
must use an extended FCB. which is the sample portion beginning with FCB_PRE. 
FCB_PRE is set to FFh. signaling that the FCB extension is active. Vou set the FILE_ATTR 
file attribute to specify the combination of file attributes you want to search for. 
Table 21.3 shows possible settings of this byte. 
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Table 21-3- Extended I (II at lunate nyie sen my> 


Value 


Types of Piles Searched 


O Normal files 

2 Normal ami hidden files 

■i Normal and system files 

6 Normal, system, and hidden files 

8 Volume label* only 

16 Directory hies 




If the search is successful. DOS returns a 0 in Al. and constructs a full FCB 
(either normal or extended) at the 1)1 A location specified through service 211 A. If 
the search is unsuccessful. Al. contains FFh; the D1A remains undisturbed. 

Notice that this service allows you to use only FCBs Because FCB file encoding 
docs not allow tor pat*' names, any file operations must be performed in the current 
disk subdirectory. With floppy disks, this limitation may not be a problem, but with 
fixed disks the limitation can be serious Refer to service 21 -ili. another method of 
searching for files, which does not have this limitation. 


Search for Next File-Name Match, Using FCB 
(Interrupt 21h, service 12h) 

Category*: Disk services 

Registers on Entry: 

AH. I2h 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

Al.. Status byte 

Memory Affected: If a file-name match is located. DOS fills in the memory area 
specified as the DTA so that it reflects a completed FCB for the file. DOS alters the 
original FCB area to allow* subsequent searching with service 21/12. 
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Syntax: 

PUSH CS 
POP DS 

MOV DX.OFFSET FCBJ 
MOV AH,12h 
INT 2ih 


;Cooe segment and 
; data segment are same 
;Offset address of FCB 

;DOS services interrupt 


Description: Use this service to locate (in the current director)* of a disk drive) a 
file with a specified name, based on a file control block, or FCB. Before you invoke 
this service, you must set the FCB by a call to service 21/11. If the FCB is not set. the 
results can be unpredictable. For more information, see the description for service 


Because any given director)* must contain unique tile names, this service is 
useless if the file specification for which you are searching does not contain the 
question-mark wild card (?). 


Delete File, Using FCB (Interrupt 21h, service 13h) 

Category: Disk services 
Registers on Entry: 

AH: 13h 

DX: Offset address of FCB 

DS Segment address of FCB 

Registers on Return: 


VL: Status byte 


Memory Affected: None - 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

OS 

; data segment are same 

• MOV 

DX .OFFSET FCBJ 

;Offset address of FCB 

MOV 

AH,l3h 


INT 

21 h 

;D0S services interrupt 


Description: Use this service to delete files by means of a file control block, or FCB. 
The FCB consists of bytes constructed in the following manner: 
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FCb_P«E 

DB 

OFFh 

Extension flag 


DB 

5 DUP(O) 

Unused 

FIIE_ATTR 

OB 

00 

File attribute 

FCB_1 

DB 

00 

Set for default drive 

F1LE_R00T 

DB 

•FILENAME' 

File name root 

F1LE_EXT 

DB 

.???. 

File name extension 

BL0CK_NUM 

DW 

0000 

Current block number 

REC_SI2E 

DW 

00CJ 

1 Record size 

FILE_S1ZE 

DO 

00000000 

;File size 

FILEJJATE 

DW 

0000 

;File date 

FILE_TIME 

DW 

0000 

;File time 


DB 

8 DUP(0) 

;D0S work area 

REC_NUM 

DB 

00 

;Current record number 

RANDOM REC 

DD 

00000000 

•.Random record number 


When you invoke this service, specify the offset address of FC8_1 in DS:DX. 
If you are using an extended FCB. use the offset address of FC8_PRE. To call this 
service, you must specify the values for fcb_i (the drive designator). FILE_R00T. and 
filE_EXT. Notice that the drive designator i*. different from the normal method 
for DOS and BIOS drive designation In ihi> instance. 0 represents the default drive, 
and 1 =A. 2 —B. 3=C, etc. 

A useful feature of this service is that you tan use the question mark (?) as a wild 
card in the file-name specification of the 1 : CB In the sample FCB, any file with the 
name FILENAME and any extension is deleted 

Notice that this service allows you to use only FCBs Because FCB file encoding 
does not allow for path names, any files deleted must reside in the current disk 
subdirectory With floppy disks, this limitation mav not be a problem, but with fixed 
disks, the limitation can be serious Refer to service 2 P-i 1. a method of deleting files 
that does not have this limitation. 



Sequential Read, Using FCB (Interrupt 21h, service l4h) 

Category: Disk services 
Registers on Entry: 

AH. l-»h 

DX: Offset address of FCB 

IJS. Segment address of FCB 

Registers on Return: 

AL: Status byte 
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Memory Affected: 1 he memory area designated as OTA is overwritten with 
information read from the disk. 

Syntax: 


PUSH CS 

POP OS 

MOV DX,OFFSET FCB_1 
MOV AH,14 h 

INT 2lh 


{Code segment and 
; data segment are same 
{Offset address of FCB 

;DOS services interrupt 


Description: I his service is used to read a block of information from a file that has 
been opened to the D'l A. You designate the block size through the file control block, 
or FCB. The FCB consists of 44 bytes constructed in the following manner: 


FCB_PRE 

DB 

0FFh 

{Extension flag 

' 

DB 

5 DUP(0) 

{Unused 

FILE_ATTR 

DB 

00 

{File attribute 

FCB_1 

DB 

00 

{Set for default drive 

FILE_R00T 

DB 

FILENAME’ 

{File name root 

FILEEXT 

DB 

’DAT’ 

{File name extension 

BL0CKNUM 

DW 

0000 

{Current block number 

REC_SIZE 

DW 

0000 

{Record size 

FILE_SIZE 

DD 

00000000 

{File size 

FILE_DATE 

DW 

0000 

{File date 

FIIE_TIME 

DW 

0000 

{File time 


DB 

8 OUP(0) 

;D0S work area 

REC_NUM 

DB 

00 

{Current record number 

RAND0M_REC 

DD 

00000000 

{Random record number 


When you invoke this sen-ice. specify the offset address of FCB_i in DS:DX. If 
you are using an extended FCB, use the offset address of fcb_pre. Before you open 
the file, set the values for FCB_i (the drive designator). FILE_R00T, and FliE_EXT. 
Specify the size of the block to be read in the REC_SIZE field. The values in BcOCK NUM 
and REC_num designate where in the file the read is to begin; these fields are 
incremented automatically after a successful read 

'X'hen the service is completed, the value of Al. indicates the status of the 
operation. If AJ. is 0. the read was successful. If Al. is 1, no data was read because the 
end-of-file was encountered by a previous read command If AL is 2. the 1)1 A 
crossed a segmvtit boumlary (a memory address ending in 000), and an error was 
generated. If AL is 3. the end-of-file was reached during the read and the service could 
not read the entire block (the partial block was read and placed in the DTA area). 
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Sequential Write. Using FCB (Interrupt 2111, service 15h) 

Category: Disk mtmun 
R egisters on F.ntry: 

All: ISh 

f)X: Offset address of FCB 

1)5: Segment address of FCB 

Registers on Return: 

AL: Status hue 

Memory- Affected: None 

Syntax: 


PUSH 

CS 

;Code segment and 

POP 

OS 

; data segment are same 

MOV 

OX,OFFSET FCB_1 

;0ffset address of FCB 

MOV 

AH,15h 


I NT 

21h 

;D0S services interrupt 


Description: This service is used to write a block of information from the DTA to an 
open file. You designate the block size through the file control block, or FCB. The 
FCB consists of 44 hues constructed in the following manner: 


FCB_PRE 

OB 

OFFh 

;Extension flag 


DB 

5 0UP(0) 

;Unused 

FILE_ATTR 

OB 

00 

;File attribute 

FCB_1 

OB 

00 

;Set for default drive 

FILE_R00T 

DB 

FILENAME' 

;File name root 

FILE_EXT 

OB 

OAT* 

;File name extension 

BLOCKNUM 

ow 

0000 

;Current block number 

REC.SIZE 

DW 

0000 

;Record size 

FILE.SIZE 

00 

00000000 

;File size 

FILE_0ATE 

OW 

0000 

;Fiie date 

FILEJTUE 

DW 

0000 

;Fiie time 


OB 

8 0UP(0) 

;00S work area 

REC_NUM 

DB 

00 

;Current record number 

RAN00M_REC 

DO 

00000000 

;Random record number 


You specify the offset address of FCB_i in DS.DX when you invoke this service. 
If you are using an extended FCB. you should use the offset address of FCB PRE. 
You should set the values for fcb_i (the drive designator), file ROOT, and FILE* EXT 
before you open the file. You specify-’the size of the block tobe written in theREC SIZE 
field The values in block_num and REC_num designate where in the file the writing 
is to begin. After a successful write, these fields are incremented automatically. 
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Create File, Using FCB (Interrupt 21h t service 16h) 

Category; Disk services 
Registers on Entry*: 

AH: 16h 

DX: Offset address of FCB 

DS: .Segment address of FCB 

Registers on Return: 

AL: Status byte 

Memory'AfTected: If the file is created successfully. DOS Alls in the FCB 
(speciAed by DS:DX) to reflea the status of the file. 

Syntax: 


PUSH CS 

POP OS 

MOV DX,OFFSET FC8_1 

MOV AH,16h 
IMT 21 Vs 


;Coda segaent and 
I data segaent ara aaaa 
;Offset address of FCB 


21n ;OOS services intarrgpt 

Description: This service uses the information in the file control block or FC* 
to create or truncate a disk Ale. This FCB is a block of Information that the 
programmer initially «eu and DOS subrequcntly completes. The FCB consfaa trf-M 
bytes constructed in the following manner: 


FCB_PRE 

OB 

BFFIt 

;Extension flag 


OB 

5 0UP<B) 

;Unused 


06 

OB 

;File attribute 

FCB_1 

OB 

00 

;Set for default drive - 

FILEJtOOT 

OB 

FILENAME’ 

;File neae root 

FILE_EXT• 

06 

’EXT* 

;File neae extension 

blocknum 

oar 

0000 

;Currant block nuabor 

REC.SI2E 

on 

0000 

;Record size 

FILE_SI2E 

00 

00000000 

;Fiie size 

file_oate 

on 

0000 

;File date 
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F11E_TIME 

DW 

0000 

;File time 


DB 

8 DUP(0) 

;D0S work area 

REC_NUM 

08 

00 

;Current record number 

RANDOM REC 

DO 

00000000 

;Random record number 


You specify the offset address of FCB_i in DSDX when you invoke this ser¬ 
vice. If you are using an extended FCB. you should use the offset address of FCB_PR£. 
To call this service, you must speeih' the values for FCB_1 (the drive designator), 
FILE_ROOT. and FILE_EXT. Notice that the drive designator is different from the 
normal method for DOS and BIOS drive designation. In this instance, 0 represents 
the default drive, and 1=A. 2 = B. 3=C. etc. 

If you use the FCB extension area, you can specif)' the attribute of the file being 
t reated. In the example, the extended FCB begins with the area shown as FCB_Pfl£. 
FCB_PRE is set to FFh. signaling that the FCB extension is active. The fil£_attr file 
attribute is set to specify the file attribute for the new file. 

If the file name specified in the FCB already exists in the current directory, the 
file is opened and its length is truncated to 0. 

If the file is created successfully. DOS returns a 0 in AL. In addition, the service 
sets FCB_i to reflect the drive number (1 =A. 2 = B. 3=C, etc.), and sets BL 0 CK_num to 
0. REC.SI2E to 80h. and filE_SI2E. FILE_DATE, and FILEJTME to their appropriate 
values for the new file. If the open operation is unsuccessful, DOS returns FFh in 
AL and does not fill in the FCB. 

When this service is completed, the specified file is left open. You do not need 
to open the file, but you must remember to close it. 

Notice that this service allows you to use only FCBs. Because FCB file encoding 
does not allow for path names, any file operations must be performed in the current 
disk subdirectory. With floppy disks, this limitation may not be a problem, but with 
fixed disks the limitation can be serious. Refer to service 21/3C; this method of 
creating files does not have this limitation. 



Rename File, Using FCB (Interrupt 21h, service 17h) 

Category: Disk services 

Registers on Entry: 

AH: 17h 

DX: Offset address of modified FCB 

DS: Segment address of modified FCB 

Registers on Return: 

AL: Status byte 
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Memory Affected: None 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

MOV 

OX, OFFSET FCB_1 

•.Offset address of FCB 

MOV 

AH,17h 

• 

INT 

2th 

;DOS services interrupt 


Description: This service uses information contained in ii modified file control 
block, or FCB. to rename a file in the current directory. This modified FCB consists 
of -44 hues constructed in the following manner: 


M00_FCB 

DB 

BB 

;Set for default drive 

OLD_ROOT 

OB 

OLD_FIlE' 

{Original file root 

OLD.EXT 

OB 

•EXT' 

;Original file extension 


DB 

5 DUP(B) 

;00S work area 

NEW_ROOT 

DB 

' METAFILE' 

;New file root 

NEW_EXT 

DB 

EXT' 

;New file extension 


DB 

16 DUP(B) 

;DOS work aroa 


You specify the offset address of MOD_FCB.in DS:DX when you invoke this 
service. To call this service, you must specify the values for MOD_FCB (the drive 
designator), OLD_ROOT, and OLD_EXT. Notice that the drive designator is different 
from the normal method for DOS and BIOS drive designation. In this instance, 0 
represents the default drive, and ? =A, 2=B, 3=C. etc. 

If the renaming operation is successful. DOS returns a 0 in AL. If the operation 
is unsuccessful, DOS returns FFh in AL.. 

This service does not allow you to rename files outside the current directory. 
With floppy disks, this limitation may pot be a problem, but with fixed disks the 
limitation can be serious. Refer to service 21/56; this method of creating files does 
not have this limitation. 



Get Current Drive (Interrupt 21h, service 19h) 

Category: Disk services 
Registers on Entry: 

AH:• 19h 

Registers on Return: 

AL: Drive code 
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Memory Affected: None 
Syntax: 

MOV AH,19h 

IN7 21h ;DOS services interrupt 

MOV CUR_ORIV£,al ;Store drive designator 

Description: This service is used to determine the current default disk drive. The 
service has no calling parameters, and the returned value in AL is a drive code in 
which 0*A. 1 = B. 2=C. etc. 

Generally, the default disk drive is the drive from which the computer was 
hooted or the drive last set with service 21/OK. 


Set Disk Transfer Area (DTA) (Interrupt 21h, service lAh) 

Category: Disk services 
Registers on Entiy: 

AM: 1 Ah 

DX: Offset address of DTA 

DS; Segment address of DTA 

Registers on Return: Unchanged 

Mrmorv Affected: None 


Syntax' 


r'JSH 

CS 

;Code segment and 

POP 

Dl 

; data segment are same 

MOV 

Ir .t'Ft'T .“TAJ 

;Offset address of OTA 

MOV 

AM. Ar, 


I NT 

2*1 

;D0S services interrupt 


Description: When POS works with file control blocks (FCBs), DOS transfers 
information to and iro n the disk through a block of memory called the disk 
transfer an a (DTA). 

Normally, this DTA is set as a 128-byte memory area at offset 80h in the pro¬ 
gram segment prefix (PSP). You can, however, set aside for the DTA an area of 
memory in your program. If the size of the blocks you will be reading and writing is 
larger than 128 bytes, you need to specify your own DTA through this service. 
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Get FAT (File Allocation Table) Information for Default 
Drive (Interrupt 21h, service lBh) 

Category: Disk services 

Registers on Entry: 

AH: lBh . 

Registers on Return: 

Sectors per cluster 
Offset address of FAT ID byte 
Bytes per sector 
Clusters per disk 
Segment address of FAT ID byte 

Memory Affected: None 
Syntax: 


AL: 

BX 

CX 

DX 

DS 


MSV 

INT 


ah,- an 

SMn 


if*** vic*S interrupt 

WocrljMlonilUB service rerun, bas K information about the disk in the default 
On»r The information includes the number of bytes per sector (CX). the number 
of^eao mperduK erW.the number of dusters per disk (DX,, Ltd [headdress 
tnc FUe Allocation Table identification (ID) byte (DS:BX). 

_ . . ° nc r ’' M * k " ow thu Information, deriving other valuable information is easv 
>X ™Dx“' “ rmine ** of ,he disk - simply multiply CX by 

. .. Thc f lle Ai * ocal ' on T *ble (FAT) identincation byte to which DS:BX points 

in “*• byte.indkates only how the disk was 

formatted. Table 21.4 shows some possible values for the FAT ID byte. 



FO 

F8 

F9 

F9 


Disk Characteristics 

High density', 18 seaorsArack (1.44M) 
High density. 36 sectors/track (2.88M) 
Unknown identity 
Fixed disk 

Double sided, 9 sectoiVtrack (720K) 
Double sided, 15 seaorsArack (1.2M) 


continues 
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Value 

~?C 
FD 
FE 
FF 


Disk Characteristics 


Single sided. 9 sectors/track (180K) 
Double sided. 9 sectors/track (360K) 
Single sided. 8 sectorsArack (160K) 
Double sided. 8 sectorsArack (320K) 


Get FAT Information for Drive 
(Interrupt 21h, service ICh) 

Category: Disk services 

Registers on Entry: 

AH: ICh r 

DL: Drive code 

Registers on Return: 

AL: Sectors pec duster 

BX: Offset address of FAT ID byte 

CX: Bytes per sector 

DX: Clusters per disk 

DS: Segment address of FAT ID byte 

Memory Affected: None 

;Drive A: 

;DOS services interrupt 

Description: This service returns basic information about the disk in the drive 
specified by DL. The drive number is specified as A=0, B=l, 02. etc. 

The information returned by this service is identical to that for service 21/IB. 
This information includes the number of bytes per sector (CX), the number of 
sectors per cluster (AL), the number ofcfusters per disk (DX), and the address of the 
File Allocation Table ID byte (DS.BX). 

Once you know this information, deriving other valuable information is easy. 
For instance, to determine the byte capacity of the disk, you simply multiply CX by 
AL by DX. 


Syntax: 

MOV DL.0 
MOV AH,ICh 
INT 21h 
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The FAT ID byte to which DS:BX points indicates the type of disk in use 
Actually, this byte indicates only how the disk was formatted ( Refer to table 21 i for 
some possible values for the FAT ID byte.) 


Get Default Disk Parameter Block 
(Interrupt 21h, service lFh) 

Category: Disk services 
Registers on Entry: 

AH: lFh 


Registers on Return: 

A!.: Error status 

BX: Olivet address of disk parameter block 

DS: Segment address of disk parameter block 

Memory Vfifccted: None 

Syntax: 

MOV' 

IN7 2lh DOS service, inte. '.yx 

CMP AL,0FFh ;*is thei -■* ai. »r-oi : 

JE ERROR ; et. go h.'ic.-' 

Description: This service i> u^ed to reinrii 'he •>'1drc'*> of’he rh«k paraniriei nim k 
(DPB). Shown in table 21.5, rhis parameti •• table »** us«. !DO^ to rietci mii.e bu>ir 
information about the disk in the defaui r drive The structure «»i ihe DPH dittrrs 
according to which version of DC *S y» <u ai e u ing. 


Table 21.5. The disk parameter block <DPBj 

% 

Offset Byte Field Length Meaning 



Basic Structure for All Versions of DOS 


Wh 

Byte 

Drive number (0 = A. 1 = B, etc.) 

Olh 

Byte 

Device-driver unit number 

02h 

Word 

Bytes per sector 

04h 

Byte 

Sectors per cluster, minus 1 

05h 

Byte 

Sectors per cluster, as power of 2 


continues 
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Offset liyte 

Held l ength 

Meaning 

0(>l» 

\\< >rd 

Beginning sector for first FAT 

08h 

liyte 

Number of FAT copies 

tWIi 

Word 

Number of rcot directory entries 

M<li 

Word 

Beginning sector of first data duster 

01 >h 

Word 

Clusters on drive, plus 1 


Addit tonal Structure for DOS 2 or 3 Only 

«*5-h 

liyte 

Sectors per FAT 

ii'h 

Word 

Beginning sector for root directory 

I2h 

Double word 

Device-driver address 

l(>h 

liyte 

Media descriptor byte 

rh 

Byu 

Disk parameter block access flag 
(OFFh indicates need to rebuild) 

lSh 

Double word 

Address of next device parameter block 


Additional Structure for DOS 2 Only 

\< h 

W ord 

Starting cluster number for current 
directory 

n:h • 

64 bytes 

ASCI1Z of current directory path 


Additional Structure for DOS 3 Only 

ICh 

Word 

Last cluster number allocated 

lEh 

Word 

Purpose unknown; normally FFFFh 


Additional Structure for DOS 4 and 5 

OFh 

Word 

Sectors per FAT 

llh 

Word 

Beginning sector for root directory 

13h 

Double word 

Device-driver address 

17h 

Byte 

Media descriptor byte 

18h 

Byte 

Disk parameter block access flag (OFFh 
indicates need to rebuild) 

19h 

Double word 

Address of next device parameter block 

lDh 

Word 

Last cluster number allocated 

iFh 

Word 

Number of free clusters 
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On return, if AL contains 0, no error occurred; if AL contains FFH. an error 
occurred. 


Random Read, Using FCR (Interrupt 21h, service 21h) 

Category: Disk services 

Registers on Entry: * 

AH: 21 h 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

AL: Status byte 

Memory Affected: The memory area designated as DTA is overwritten with 
information read from the disk. 


Syntax*. 

t 

PUSH 

CS 

.Code segment and 

POP 

OS 

; data segment are same 

MOV 

OX,OFFSET FCBJ 

;Offset address of FCB 

MOV 

AH,21h 


INT 

21h 

;D0S services interrupt 


Description: This service is used to read a data record from an open file and place 
the information in the DTA. You designate the record size through the file control 
block, or FCB. The FCB consists of 44 bytes constructed in the following manner: 


FCB_PRE 

OB 

0FFh 

Extension flag 

9 

OB 

5 DUP(B) 

;Unused 

FILE_ATTR 

OB 

00 

;File attribute 

FCBJ 

OB 

00 

;Set for default drive 

FILE_R00T 

DB 

•FILENAME' 

;File name root 

FIIEJXT 

DB 

•DAT 1 

;File name extension 

BL0CK_NUM 

DW 

0000 

;Current block number 

REC_SIZE 

DW 

0000 

;Record size 

FILE.SIZE 

00 

00000000 

;File size 

file_date 

DW 

0000 

;File date 

filejime 

OW 

0000 

;File time 


DB 

6 DUP<0) 

;00S work area 

REC_NUM 

OB 

00 

;Current record number 

RAN00U_REC 

DO 

00000000 

;Random record number 
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You specif)' the offset address of FCB_1 in DS:DX when you Invoke this service. 
If you arc using an extended FCB. you should use the offset address of fcb_PRE. You 
should set the values for FCB_1 (the drive designator), FILE_ROOT. and file_EXT 
• before the file is opened *You specify the file’s rec'ord size in the REC_SIZE field. The 
area set aside as tHe DTA should be as large as a record. The values in REC_SIZE and 
random_RG€ specify where the file read is to begin. After a successful read, the values 
in BLOCKJUUM* and REC_.num are updated to the proper values. RANDOM_REC, which is not 
incremented by this service, remains the same as before the invocation. 

’ V . 

When the service Is completed, the value of AL indicates the status of the 
operation. If AL is 0. the read wps successful. If AL is 1, no data was read because the 
end-of-lile was encountered by a previous read command. If AL is 2. the DTA crossed 
a segment boundary (a mentor)' address ending in 000), and an error was generated. 
If AL is 3, the end-of-file was reached during the read and the service could not read 
the entire block (the partial block was read and placed in the DTA area). 


Random Write, Using FCB (Interrupt 21h, service 22h) 

Category: Disk services 

Registers on Entry: * 

AH: 22h 

DX: Offset address of FCB 

DS: Segment address of fcB 

Registers on Return: 

• • 

AL: Status byte 

Memory Affected: Certain FCB values are modified. 

Syntax: 


PUSH CS 

POP OS 

MOV DX,OFFSET FCB_1 

MOV AH,22h 

INT 21h 


;Code segment and 
; data segment, are same 
;Offset address of FCB 


* n ;D0S services interrupt . * 

S l crvice * s uscd to wr ‘ tc a data record to a previously opened fill*, 
ihroueh ft?" l ° * S comained in DTA The record size is designated 

the foUtowing manner^ The FCB of -* 4b ^ es consinicied in 
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FCB_PRE 

OB 

0FFh 

{Extension flag 

• 

DB 

5 DUP(C) 

'.Unused 

FILEJkTTR 

OB 

00 

;File attribute 

FC6_1 

OB 

00 

;Set for default drive 

FIIE_R00T 

DB 

’FILENAME* 

;File name root 

FIIE_EXT 

OB 

OAT* 

{File name extension 

BL0CK_NUU 

DW 

0000 

;Current block number 

REC_SIZE 

DW 

0000 

;Record size 

FILE_$IZE 

00 

00000000 

{File size 

FILE_DATE 

PW 

0000 

;File date 

FILE_TIUE 

DW 

0000 

;File time 


0B 

8 DUP(0) 

;OOS work area 

REC_NUM 

DB 

00 

;Current record number 

RAND0M_REC 

00 

00000000 

{Random record number 


You specify the offset address of FCB_i in DS:DX when you invoke this ser¬ 
vice. If you are using an extended FCB, you should use the offset address of FCB_PRE. 
You should set the values for FCB_1 (the drive designator), FILE_R00T, and FILE_EXT 
before the file is opened. You specify the file s record size in the REC_SIZE field. 
This size is the number of bytes that will be written by this service. The values in 
REC_SIZE and RANDOM_REC specify the location in the file at which writing is to begin. 
After a successful v 'rite, the values in BLOCK_ncm and REC_num are updat id. RANDOM_REC. 
which is not incremented by this service, remains the same as before the invocation. 

When this service is completed, the value of AL indicates the status of the 
operation. IfALisO, the write was successful. IfALis 1, a disk-full error was detected 
during the write. If AL is 2, the DTA crossed a segment boundary (a memory address 
ending in 000), and an error was generated. 


Get File Size, Using FCB (Interrupt 21h, service 23h) 

Category: Disk services 
Registers on Entry: 

AH: 23h 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

* AL: Status bvte 

• * 

Memory Affected: Certain FCB values arc modified. 
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Syntax: 


PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

MOV 

DX.OFFSET FCB_1 

;0ffset address of FCB 

MOV 

AH,23h 


INT 

21h 

;D0S services interrupt 

CMP 

AL,0FFh 

;Was the file found? 

JE 

FIIE_ERR 

;no, so handle error 


Description: This service searches for a specific file name in the current directory 
and returns the number of records in that file. You specif)' the file name to be used 
in the file control block or FCB The I C B consists of -n bytes construcu d m the 
following manner. 


FCB_PRE 

DB 

CFFh 

•.Extension flag 


OB 

S DUP(O) 

;unused 

FILE_ATTR 

OB 

cc 

;File attribute 

FCB_1 

DB 

03 

;Set for default drive 

FILE_R00T 

06 

FILENAME' 

;File name root 

file_ext 

OB 

DAT' 

;File name extension 

B10CK_NUM 

DW 

0000 

;Current block number 

REC_SIZE 

0W 

0000 

;Record size 

FILE_SIZE 

DD 

00000000 

;File size 

FILEJ)ATE 

DW 

0000 

;File date 

FILE_TIUE 

OW 

0000 

;File time 


OB 

8 DUP(0) 

;D0S work area 

REC_NUM 

OB 

00 

;Current record number 

RAND0M_REC 

DD 

00000000 

;Random record number 


You specify the offset address of FCB_i in DS DX when you invoke thus ser 
vice. If you are using an extended FCB, you should use the offset address of FCB_PRE. 
To use this service, you should set the values for FCB_i (the drive designator). 
FILE_ROOT, and FILE_EXT. The value in REC_SIZE indicates the record size in the file 
and has a direct bearing on the returned value. If this field is set to 1. the value 
returned by this service is equal to the number of bytes in the file. 

On return, the value of AL indicates the status of the operation. If AL is 0. the 
file was located, and ihe value in Randomrec indicates the number of records (of size 

REC-SIZE) in the file If AL is FFh, the requested file could not be located, and the FCB 
values are not signiliear' 
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Set Random Record Field in FCB 
(Interrupt 21h, service 24h) 


Category: Disk services 

Registers on Entry: 

AH: 24h 

DX: Offset address of FCB 

DS: Segment address of FCB 

• 

Registers on Return: Unchanged 

Memory Affected: Certain FCB values are modified. 


Syntax: 



PUSH 

CS 

;Code segment and 


POP 

DS 

; data segment are same 

• 

MOV 

OX,OFFSET FCB_1 

;Offset address of FCB 


MOV 

AH,24h 


- 

INT 

<21 n 

;DOS services interrupt 



Description: This service modifies the contents of the random record field in the 
file control block (FCB) of an open file. The FCB is a 44-bvte area constructed as 
follows!'.' 


FCB_PRE 

OB 

•FFh 

Extension flag 


OB 

5 OUP(B) 

;Unused 

FILE_ATTR 

OB 

M 

;File attribute 

FCB_1 

OB 

M 

;Set for default drive 

FIIE_R00T 

OB 

'FILENAME' 

;File name root 

FILE_EXT 

OB 

'OAT' 

;File name extension 

BLOCKNUII 

OH 

MM 

;Current block number 

REC.SIZE 

OW 

BBM • 

;Record size 

FILE_SIZE 

00 

0OM0OM 

;File size 

FILE_OATE 

OW 

000® 

;File date 

FILEJTME 

OW 

MOO 

;File time 


OB 

8 DUP(0) 

;00S work area 

REC_NUM 

OB 

00 

;Current record number 

RANDOM REC 

DO 

ooooMoe 

;Random record number 


You specify the offset address of FCB_i in DS:DX when you invoke this ser¬ 
vice. If you are using an extended FCB, you should use the offset address of FC8_PRE. 
Before you call the service, set the values for FCB_i (the drive designator), FILE_ROOT, 
and file_ext for the open file Also set the values in REC_SIZE. REC_num. and block_num 
before calling this service. These values nre used to compute the value in RANDOU_REC. 
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Set Interrupt Vector (Interrupt 21h\ serv ice 25h) 


Category: System services 
Registers on Entry: 

AH: 25h 

AL: Interrupt number 

DX. Offset addrr: s of new interrupt handler 

US Segment address of new interrupt handler 

Registers on Return: Unchanged 

Me m o r y Affected: The values in the interrupt vector table in low memory are 


altered 

• 


Syntax: 


PUSH 

OS 

;Save current data segment 

UOV 

AL, 5 

;Pnnt-screen interrupt 

PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

UOV 

OX,OFFSET PS_HANDLER 

;Offset address of handler 

UOV 

AH,25h 


I NT 

21h 

;DOS services interrupt 

POP 

DS 

;Restore dpta segment 


Description: This service provides a uniform method for altering the interrupt 
vector table in low memory. Such a method is useful if you want to alter or replace 
the way the system currently handles interrupts. 

An important consideration is that, once changed, the old interrupt vector is 
lost. You can use service 21/35 to determine the current vector so that you can save 
the vector before changing it. Then, on program completion, you can reset the 
vector to the original value. 


Create Program Segment Prefix (PSP) 
(Interrupt 21h, service 26h) 

Category: System services 
Registers on Entry: 

AH: 26h 

DX Segment address of new PSP 
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Registers on Return: Unchanged 

Memory Alfectcd: The 256 bytes of memory at the desired segment address arc 
altered. 

Syntax. 

MOV OX,OFFSET CS:PROG_END ;Point to end of program 

MOV AH,26h 

2lh ;D0S services interrupt 

Description: This service, which is used to facilitate overlays and subprograms to 
the current orogram. copies the current PS1* contents to the desired paragraph and 
then sets the PSP vector contents to match the contents of the interrupt vector table. 

The current DOS technical reference manuals (those supplied with DOS 
versions released since version 3.0) recommend that this service not be used; 
instead, they recommend .using service 21/sB. 


Read Random Record(s), Using FCB 
(Interrupt 21h, service 27h) 

Category: Disk services 
Registers on Entry: 

AH: 27 h 

CX: Number of records to read 

DX: Offset address of FCB 

DS: Segment address of FCB 

Registers on Return: 

AL: Status byte 

CX: Number of records read 

Memory Affected: The memory designated by DTA is overlaid with information 
read from the disk. 

Syntax: 


PUSH 

cs 

POP 

OS 

MOV 

OX,OFFSET FCB_1 

MOV 

CX,8 

MOV 

AM.27H 

INT 

21h 


;Code segment and 
; data segment are same 
;0ffset address of FCB 
;Read 8 records 

;D0S services interrupt 
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Description: This scn ice is used to read a specified number of data records from 
a previously opened file and to place the information in the DTA. You specify the 
number of records to read in CX. Designate the record size through the file control 
block, or FCB. The FCB consists of 44 bytes constructed in the following manner: 


fcb_pre 

DB 

BFFh 

;Extension flag 


OB 

5 DUP(B) 

;Unused 

file_attr 

OB 

00 

;File attribute 

FCB_1 

OB 

00 

;Set for default drive 

ILE.RClOT 

DB 

'FILENAME' 

;File naae root 

FIl.EcXT 

OB 

'DAT' 

;File name extension 

Bl .“K_NUM 

OH 

0000 

;Current block number 

REC_SIZE 

OH 

0000 

;Record size 

FILE_SIZE 

00 

00000000 

;File size 

file_oate 

OH 

0000 

;File date 

FILE_TI ME 

OH 

0000 

;File time 


08 

8 DUP(0) 

;D0S work area 

REC_NUM 

08 

•0 

;Current record nunber 

random_rec 

DO 

00000000 

;Random record nunber 


You specify i.. k offset address of FCB_i in DS:DX when you invoke this ser¬ 
vice. If you arc using an extended FCB. you should use the offset address of FC8_PRE. 
You set the values for FCB_i (the drive designator), FILE_R00T, and FILE_EXT before 
the file is opened. You specify the file's record size in the REC.SIZE field. The area set 
aside as the DTA should be large enough to contain the number of records being 
r^ucsicd. The values in REC.SIZE and Randou_rec specify the location in the file at 
which the read is to begin. After a successful read, the s er vice updates the varies 
m olOCk_num, rec.nuu, and random_rec. 

When this service is completed, the value of AL indicates the status of the 
operation. If AL is 0. the read was successful. If AL is 1, no data was read because the 
end-of-file was already reached. If AL is 2, the DTA crossed a segment boundary (a 
memory address ending in 000) and an error was generated. If AL is 3, the end-of- 
file was reached during the read; the service could not read an entire block (the 
partial block is still read and placed in the DTA area). CX contains the number of 
records read. 


Write Random Record (s), Using FCB 
(Interrupt 21h, service 28h) 

Category: Disk services 
Registers on Entry:* 

AH « 28h 

CX ^Number of records to write 
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DX. Offset address of FCB > 

DS: Segment address of FCB 

Registers on Return: 

AL Status bvte 

# % 

CX: Number of records written 

Memory Affected: Certain FCB values are modified. 
Syntax: 


PUSH CS 

POP DS 

MOV DX,OFFSET FCB_1 
MOV CX.8 

MOV AH,28h 

INT 21h 


;Code segment and 
« data segment are same 
:Offset address of FCB 
;Write 8 records 

;DOS services interrupt 


Description: This service is used to write a specific number of data records to a 
previous y opened file. The information to be written is contained in the DTa You 

° f rs 0 *? IO bC " Ti,ten in CX You the record size 

hrough the file control block, or FCB. The FCB consists of -m bytes constructed in 
the following manner: • - • 


FCB_PRE 

db 

0FFh 

Extension flag 


db 

5 DUP(0) 

;Unused 

FILE_ATTR . 

DB 

00 

;File attribute 

FCBJ1 

DB 

00 > v . 

J. ;Set for default drive 

FILE_R00T 

DB 

T 

'FILENAME' 

;File name root 

FILE_EXT 

DB 

'DAT' 

;File name extension 

BLOCK_NUM 

DW 

0000 

;Current block number 

REC_SIZE 

OW 

0000 

;Record si 2 e 

FILE_SIZE 

DD 

00000000 

;File size 

file_date 

OW 

0000 

;File date 

FILEJTIME 

DV/ 

0000 

;File time 

. 

DB 

8 DUP(0) 

;D0S work area 

REC_NUM 

DB 

00 

;Current record number 

bandom_rec 

DD 

00000000 

;Random record number 


You specify the offset address of FCB_1 DS:DX when you invoke this service 
If you are using an extended FCB, you should use the offset address of FCB pre. 
You set the values for FCB_1 (the drive designator), file_R00T. and file_ext before 
*he file is opened. Specif>' the file’s record size in the REC_SIZE field. The values in 
re C_SIZE and RANDOM_REC specify the location in the file at which writing is to begin. 
Afar a successful write, the service updates the values in BLOCK_NUM, REC_num, and 
RANDOMREC. 
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When this sen-ice Is completed, the value of AL indicates the status of the 
operation, if AL is 0, the write was successful. If AL is 1, a disk-full error was detected 
during the write. If AL is 2, the DTA crossed a segment boundary (a memory address 
ending in 000), and an error was generated. CX contains the number of records 

written. k 


Parse File Name, Using FCB (Interrupt 21h, service 29h) 

Category: Disk services 
Registers on Entry: 

AH: 29h 

AL: Parsing control byte 

SI: Offset address of string to be parsed 

DI: Offset address of FCB 

DS: Segment add/ess of string to be parsed 

ES: Segment address of FCB 

Registers on Return: 

AL: Status byte 

SI: Offset address of first character following parsed string 

DI: Offset address of FCB 

DS: Segment address of first character following parsed string 

ES: Segment address of FCB 

Memory Affected: Certain values in the FCB are altered. 


Syntax: 


PUSH 

DS 


PUSH 

ES 

Save extra segaent 

MOV 

AX,CS 

Code, data, and extra 

MOV 

DS.AX 

segments are all 

MOV 

ES,AX 

the same 

MOV 

SI,OFFSET INPUT 

Offset address of string 

MOV 

DI,OFFSET FCEM 

Offset address of FCB 

MOV 

AL ,00001111b 

Set proper parse control 

MOV 

AH,29h 


INT 

21h 

DOS services Interrupt 

POP 

ES 

Restore extra segment 

POP 

DS 

Restore data segaent 
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Description: This sc nice is used to parse (translate) a text string to pick out a valid 
drive designator, file name, and file extension The service parses for simple drive 
and file-name designations only, not tor path names 


05 51 points to the text string to be parsed, and PS D! points to the memory 
area that will hold the constructed FCB. This area should be at IcaM n Into in 
length. 

The four low-order bits of AL control how the text string is parsed. Table 21 (> 
details the meanings of the bit settings. 


Table 21.6. Bit settings for AL register, service 21/29. 
Bits 

76543210 Meaning 


0000 

0 

1 


0 

1 


0 

1 


0 

1 


Reserved—must be set to 0. 

File extension in FCB is set either to parsed value or to 
blanks. 

File extension in FCB is set only if a valid extension is 
detected in the text string. 

File name in FCB is set either to parsed value or to blanks. 

File name in FCB is set only if a valid file name exists in the 
text string. 

Drive ID byte is set either to parsed value or to 0. 

Drive ID byte is set only if a valid drive designator is parsed 
in the text string. 

Leading separators arc not ignored; parsing stops when 
one is encountered. 

Leading separators are ignored. 


This service correctly translates wild-card characters (* and ?) to the appropri¬ 
ate FCB values. 

On return, AL indicates the parsing status. If AL=0, no wild-card characters 
were located in the text string. If AL=1, the text string contained wildcard 
characters Jf AL=FFh, the drive specifier was invalid. In all instances. ES:Dl points 
to the first byte of the new FCB. 
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Part IV: Reference 


Get System Date (Interrupt 21h, service 2Ah) 


Category': Date/time services 


Registers on Entry: 

AH- 2 Ah 

Registers on Return: 

AL: Day of week (0-6) 

CX: •• Year (1980-2099) 

DH: Month (1-12) 

DL: Day (1-31) 

Memory Affected: None 

Syntax: 

MOV AH,2Ah 

INT 2ih ;D0S services interrupt 

Description: This sen-ice. which returns the system date, returns the month (DH), 
day (DL). and vearjtCXL along with the day of the week for this date. The day of the 
week is returned in AL as u=Sunda>, 1 = Monday, 2=Tuesday, etc. 


' Set System Date (Interrupt 21h, service 2Bh) 

Category: Date/time semces 
Registers on Entry: 

• 

AH: 2Bh • 

CX: Year (1980-2099) 

DH: Month (1-12) 

DL: Day (1-31) 

Registers on Return: 

AL: Status bvte 

Memory Affected: None 

Syntax: 

* 

MOV OH.MONTH ;Get current month 

MOV DL,DAY ;Get current day 
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0K_G0: 


MOV 

CX,YEAR 

CMP 

CX.100 

JA 

0K_G0 

ADD 

CX,1900 

MOV 

AH,2Bh 

INT 

21h 

CMP 

AL,0 

JNE 

DATE ERROR 


;Get current year 
;Does CX include century? 
;Yes, so continue 
;No, so adjust 


;DOS services interrupt 
;Was there an error? 

;Yes, go handle 

Description: This service allows the DOS date (system software clock) to be set but 
does not set the real-time hardware clock on the IBM '.’ersonai Computer AT or 
compatibles. 

To use this service, you must load a valid month, day, and year into DH. DL. 
and CX, respectively. On return, AL contains either a 0 (indicating that the date was 
valid and has been set) or FFh (indicating that the specified date is invalid). 


r 


Get System Time (Interrupt 21h, service 2Ch) 

Category: Date/time services 

Registers on Entry: 

AH: 2Ch 

Registers on Return: 

CH: Hour (0-23) 

CL: Minute (0-59) 

DH: Second (0-59) 

DL: Hundredths of a second (0-99) 

Memory Affected: None 

Syntax: 

MOV AH,2Ch 

INT 21 h ;D0S services interrupt 

Description: This service converts the value of the computer's system-software 
clock counter to values that humans readily understand: hours (CH). minutes (CL), 
seconds (DH), and hundredths of seconds (DL). The hours (CH), which are 
returned in military time, range from 0 to 23. 
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Set Time (Interrupt 21h, service 2Dh) 

Category: Datc time services 

Registers oh Entry: 

AH: 2Dh 

CH: Hour (0-23) 

CL: Minute (0-59) 

DH: Second (0-59) 

DL: Hundredths of a second (0-99) 

Registers on Return: 

AL: Status byte 

Memon- Affected: None 

Syntax: 


MOV 

CH.HOMR 

;Get current hour 

MOV 

CL.MINUTE 

;Get current minute 

MOV 

DH,SECOND 

;Get current second 

MOV 

DL ,0 

;Hundredths doesn't matter 

MOV 

AH,2Dh 

1 _ - 

I NT 

21 h 

;D0S services interrupt 

CMP 

AL, 0 

;Was there an error? 

JNE 

TIME_ERR0R 

;Yes, go handle 


Description: This service converts a specified time to the correspondine number of 
clock ticks and stores the resulting value in the computer s software clock counter 
This service does not reset the real-time clock on the IBM Personal Computer AT or 
compatibles. f 

This service determines, thr. -h a series of multiplications, the number of 
clock neks represented by the specifi 1 time The entered values are converted to 
a total number of seconds, which then is multiplied hv 19 "\")65 annmyimiM. 
number 0 , clock ricks per second,. For example, I, you a're L.ring SfeTmTm 

following 59 ( " lr> ' " me) ' c Compu,cr 8°“ ‘hrough conversions similar to the 
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14 hours = 14 • 60 • 60 - 

22 minutes = 22 * 60 = 

17.39 seconds = 17 . 39 = 

50400 

1320 . 

17.39 

seconds 

seconds 

seconds 

Total: 

Clock ticks per second = 

51737.39 

18.2065 

seconds 

ticks 

Ticks represented: 

941956.7910 

ticks 


Because fractional ticks cannot be represented, the total number is rounded 
to 941,957 ticks. The system software clock is then set to this value. The same type 
of process sets the system clock with the BIOS datc/time services (refer to Chap¬ 
ter 20, service 1A/4). As a programmer, you .can easily see the added value of 

some of these DOS services. 

% 

On return. AL contains either a 0 (indicating that the time was valid and has 
been set) or FFh (indicating that the specified time is invai'd). 


Set Verify Flag (Interrupt 21h, service 2Eh) 

Category: Disk services 

Registers on Entry: 

AH: 2Eh 

AL: Verify setting 

DL: 0 


Registers on Return: Unchanged . 
Memory Affected: None 
Syntax: 


MOV 

AL, 1 

;Set verify on 

MOV 

DL, 0 


MOV 

AH, 2Eh 


I NT 

2lh 

;D0S services Interrupt 


Description: This service sets the system flag that determines whether DOS 
performs a verify operation after each disk write to ensure that information has 
been recorded accurately. In most applications, the reliability of DOS operations is 
such that you safely can leave the verify flag set off (the default setting). 
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I lv setting ol Dl. no * 
version-: lor earlier versions, 
men led necessity; no reason 


important if yon are working with DOS .4.0 or later 
however. 1)1. must he set to 0. This is an undocu- 
is given for this setting. 


If you are working with a network system. 


verification is not supported; the 


setting has no meaning. 


Get Disk Transfer Area (Interrupt 21h, service 2Fh) 


Category: Disk services 
Registers on Entry: 


Registers on Return: 

LJX Offset address of DTA 

HS: Segment address of DTA 

Memory Affected: None 

Syntax: 

MOV AH,2Fh 

INT 2lh ;00S services interrupt 

Description: This service returns the address of the current DOS disk transfer area 
(DTA) DOS uses this area to transfer information between the computer and the 
disk. The address is returned in ES:BX. 

Note that all services with numbers lower than 2Fh are available in all 
distributed versions of DOS. This service and all that follow it (numerically, up to 
serv ice 58h) became available only with the release of DOS 2, however. 




Get DOS Version Number (Interrupt 21h, service 30h) 

Category: System services 

Registers on Entry: 

AH: 4<)h 

Ala 0 
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Registers on Return: 

aL: Major version number 

AH; Minor version number 

BL. High-order 8 bits of 24-bit user serial number 

BH OEM serial number 

CX: ljow-order 16 bits of 24-bit user serial number 


Memory Affected: None 
Syntax: 


M\l 

AH,3Qn 


MOV 

AL, 0 


1NT 

2ih 

;D0S services interrupt 

CUP 

AL ,2 

;At least version 2.0? 

JB 

DOS .BAD 

;No, so exit ear',- 


Description: This service determines the version number of the DOS that is 
operating within the computer (the DOS used during booting). If the DOS 5 
SliTVKR command has been used, this serv ice returns the value set by that command. 

The major purpose of this ‘«rvice is to allow programs to determine whether 
the proper version of DOS is in use for certain functions and services. Al. contains 
the rnaior version number (2 or 3). If AL contains 0. the DOS version is earlier than 
2 0 The minor version number returned in AH is the number to the right o t il 
decimal point (to two decimal place) Depending on the OEM that distributc-d the 
version of DOS, BH will contain an OEM-specific serial number, and BL CX vull 
contain a 24-bit user serial number. 



Terminate and Stay Resident (Interrupt 21h. serv ice 31h) 

Category: System services 

Registers on Entry: 

AH: 31h 

AL: Return code 

DX: Memory paragraphs to reserve 

Registers on Return: Indeterminable (does not return) 

Memory Affected: The available free memory is decreased by the number ol 
paragraphs specified in DX. 
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Syntax: 


MOV AL,0 

;Return code of 0 

MOV nx.100h 

;Reserve 4K of info 

MOV AH,31h 


1NT 2lh 

;00S services interrupt 


Dcscriprion: This sen-ice is used to exit a program, leaving all or part of the 
program's memory intact. The sen-ice is used by a wide variety' of TSR (terminate- 
and-stay-resident) programs such as SideKick. FroKev. etc. 

The return code you specify- in AL when you invoke this service is passed to 
the parent program or to DOS. From DOS-commnnd level, the return code is 
available through the ERRORLEVEL batch command: from programs, the return code 
can be determined through sen-ice 21/4D. 

The number of paragraphs requested in DX arc resened by DOS and unavail¬ 
able to other programs. The buffers of any files opened prior to invoke, g this sen'ice 
are flushed, but the files are left open. 

a s aac saaz g ™ 

Her Disk Parameter Block (Interrupt 21h, service 32h) 

Category : Disk sen-ices 

Registers on Entry: 

AH: 32h 

DL: Drive number 

Registers on Return: 

AJL: Error code 

BX: Offset address of disk parameter block 

I>S: Segment address of disk parameter block 

Memory Affected: None 

Syntax: 


MOV 

AH,1Fh 


MOV 

DL ,3 

;get info for drive C 

INT 

2ih 

;D0S services interrupt 

CMP 

AL.OFFh 

;was it an invalid drive? 

JE 

ERROR 

;yes, go handle 


mm”? 0 " 1 ' h ' S scn it c iN ust,tl return the address of the disk parameter block 
v is parameter table is used by DOS to determine basic information about 
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the disk in the default drive. The structure of the DPB differs, according to which 
version of DOS you are using. The various DPB structures are detailed in table 21.5 
(refer to service 21/IF). 

On calling this service, the drive number is specified in Dl. (0=dcfault, 1=A. 
2 = B. 3 = C, and so on). If called with DL=0, this service is identical to service 21/LF. 


Get Ctrl-Break Flag (Interrupt 21h, 
service 33h, function OOh) 

Category: System services 

Registers on Entry: 

AH: 33h 

AL: OOh 

Registers on Return: 

DL: Ctrl-Break flag setting 

Memory Affected: None 

Syntax: 

MOV AL,0 ;Getting flag 

MOV AH,33h 

INT 21h ;D0S services interrupt 

Description: This service gets the flag that controls how often DOS checks whether 
the Ctrl-Break key combination has been pressed. On return, DL contains 0 or 1, 
depending on whether the flag is off or on. 



Set Ctrl-Break Flag (Interrupt 21h, 
service 33h, function Olh) 

Category: System services 


Registers on Entry: 

AH: 33h 

AL: oih 

DL: Ctrl-Break flag setting 
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Registers on Return: Unchanged 
Memory Affected: None 
Syntax: 

MOV AL,1 ;Setting flag 

MOV dl, 0 ;Turn off Ctrl Break check 

MOV AH,33h 

INT 2lh ;DOS services interrupt 

Description: This service sets the flag that controls how often DOS checks whether 
the Ctrl-Break key combination has been pressed. Other documentation for this 
service implies that this flag turns Ctrl-Break checking on or off completely. Not 
true; this flag controls only the frequency of checking. Even with this flag set to off, 
checking is performed during certain DOS operations, such as performing video 
output. 

To set the Ctrl-Break flag, load AL with 1 and DL with the desired state of the 
flag. If DL is 0. Ctrl-Break checking is at the minimum. If DL is 1, checking is more 
frequent during virtually every DOS operation. 




Get Boot Drive Code (Interrupt 21h, 
service 33h, function 05h) 

Category: System services 

Registers on Entry: 

AH: 33h 

AL: 05h 

Registers on Return: 

DL: Boot drive code 

Memory Affected: None 

Syntax: 

MOV AL, S 
MOV AH,33h 

INT 21h ; 00 $ services interrupt 

Description: Added in DOS 4, this function returns in the DL register a code 
.nd.catmg thednve from which the system was booted (1=A,2=B, 3=C, and soon). 
•J'V" ° rmat,on ,s SIOred ,n thc DOS kernel area each time the system initializes 
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Get DOS Version Number (Interrupt 21h, 
service 33h, function 06h) 

Category: System services 

Registers on Entry: 

AH: 33h 

AL: 06h 

'Registers on Return: 

BL: Major version number 

BH: Minor version number 

DL: Revision number 

DH: DOS memory flags 

Memory Affected: None 

Syntax: 


MOV 

AH,33h 


MOV 

AL,6 


I NT 

21h 

;D0S services interrupt 

CMP 

BL,2 

;At least version 2.«? 

JB 

D0S_BAD 

;No, so exit early 


Description: This service is similar to service 2 i/30. It is used to determine the 
version number of the DOS operating in the computer (the DOS used during 
booting). The difference between the two functions is that this one returns a bit more 
information and is not fooled by the DOS 5 SETVER command. All comments for 
service 21/30 apply to this service also. 

The DOS memory flags returned in DH indicate where in memory DOS is 
loaded. If bit 3 is set, DOS is in ROM. If bit 4 is set, DOS is loaded in the high-memory 
area. 



Get Address of InDOS Flag (Interrupt 21h, service 34h) 

Category: System services 
Registers on Entry: 

AH: 34h 
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Registers on Return: 

BX: Offset address of InDOS flag 

ES: Segment address of InDOS flag 

Memory Affected: None 

Syntax: 

MOV AH,3<h 

INT 21h ;DOS services interrupt 

MOV AL,ES:|BX] ;get value of InDOS flag 

Description: The InDOS flag is used to determine whether DOS currently is 
executing an Interrupt 21h service. If the memory address pointed to by ES:BX is 
nonzero, a DOS service is in process. 

The purpose of this service is to determine when DOS service requests can 
be Issued safely in TSR (terminate-and-stay-resident) programs. 


Get Interrupt Vector (Interrupt 21h, service 35h) 

Category: System services 
Registers on Entry: 

AH: 35h 

AL: Interrupt number 

Registers on Return: 

BX: Offset address of interrupt handler 

ES: Segment address of Interrupt handler 

Memory Affected: None 

Syntax: 


PUSH ES 

PUSH BX 

MOV At,5 

MOV AH,35h 

INT 21h 

“ov is_seg_olo.es 

MOV I5_0fF_0L0,BX 

POP BX 

POP ES 


;Save registers 

;Print-screen interrupt 

;00S tar vices Interrupt 
.Store old segment 
;Store old offset 
;Restore registers 
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Description: 1 his service allows a uniform method for retrieving the address of an 
interrupt handler from the interrupt vector table in low memory. This service is used 
to determine current values so that they can be saved before changing; then service 
21/25 can be used to alter the vector. 


Get Disk Free Space (Interrupt 21h, service 36h) 

Category: Disk services 

Registers on Entry: 

AH: 36h 

DL: Drive code 


Registers on Return: 

AX: Sectors per cluster 

BX: Available clusters 

CX: Bytes per sector 

DX: Clusters per drive 

Memory’ Affected: None 

Syntax: 


MOV AH,36h 

INT 21h 

CMP AX,8FFFFh 

JE ERROR 

PUSH AX 

MUL OX 

MUL CX 

MOV BP0_HI,DX 

MOV BPDJ.O.AX 

POP AX 

MUL BX 

MUL CX 

MOV FBPD_HI,DX 

MOV FBPD_LO,AX 


DOS services interrupt 
was there an error? 

Yes, so qo handle 

Save sectors/cluster 

AX-sectors/drive 

DX:AX=bytes/drive 

Save high word 

Save low word 

Get back sectors/cluster 

AX*free sectors/drive 

DX;AX»free bytes/drive 

Save high word 

Save low word 


Description: This service returns basic information about space on the disk in 
the drive specified by DL. Notice that the drive code is different from the normal 
method for DOS and BIOS drive designation. In this instance, 0 represents the 
default drive, and 1=A, 2 = B. 3=C. etc. 
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On return from thi» service, the calling program checks AX to determine 
whether an error has occurred. If AX contains FFFFh, the drive code is .nval,d and 
ihc balance of ihe registers is undefined. 

If AX docs not indicate an error, the information this service returns is similar 
to that provided by services 21/1B and 21/1C. This information includes the number 
of bytes per sector (CX), the number of sectors per cluster (AX) the number of 
clusters per disk (DX), and the number of free clusters on the disk (BX). 

Once you know this information, ocriving other valuable information tse^Y- 
For Instance, to determine the byte capacity of the disk, you simply multiply CX by 

AX by DX. 


Get/Set Country-Dependent Information 
(Interrupt 21h, service 38h) 

Category: System services 


Registers on Entry: 

AH: 38h 

AL: Country specifier 

BX: Country specifier 

DS: Segment address of information block 

DX: Offset address of information block 

Registers on Return: Unchanged 

AX: Error code 

BX: Country specifier 

DS: Segment address of information block 

DX: Offset address of information block 

Memory Affected: If country information is retrieved, the memory block to which 
DS:DX points is overwritten with the country-dependent information. 


Syntax: 


40V 

AL,® 

;Info for current country 

PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

MOV 

DX,OFFSET INF0_BL0CK 

;0ffset address of block 

MOV 

AH,38h 


I NT 

21h 

;D0S services interrupt 
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Description: This powerful service allows you to retrieve or set a great deal of 
system information. The purposes and function of this service have changed over the 
course of several different versions of DOS. The description here conforms with the 
function of the service according to DOS 3.0. 

DOS uses the country information governed by this service to control elements 
such as the display of dates and numbers. This service allows a program great 
flexibility in handling display formats, flexibility that is particularly useful if the 
software is being used for a market other than the United States. Because most 
computers sold in the United States come configured for this country, however, this 
service may have little value for programmers whose sole market is the United States. 

To get country-dependent information, simply load DS:DX with the 
segment:ofiset address of the 34-byte memory block that will be used to store the 
retrieved information. Load AL with the country code to be retrieved, as indicated 
in table 21.7 


Table 21.7. Country' codes. 


Country 

Code 


Currently installed 

0 

United States 

1 

Canadian-French 

2 

Latin America 

3 

Netherlands 

31 

Belgium 

32 

France 

33 

Spain 

34 

Hungary 

36 

Yugoslavia 

38 

Italy 

39 

Switzerland 

41 

Czechoslovakia 

*2 

United Kingdom 

44 

Denmark 

45 

Sweden 

46 

Norway 

47 

Poland 

48 


CLmUifiues 
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Table 21.7. continued 


Germany 

49 


Brazil 

55 


Australia - 

61 


Portugal 

351 


Finland 

358 

- 

Israel 

972 



If the country code is greater than 255 (as it is for Portugal, Finland, and 
Israel), you enter FFh in AL and set BX to the country-code value. If AL is less than 
FFh, the contents of BX are not significant. Notice that if AL is 0, the country 
information table reflects the current country’s information. If a different country is 
selected, that country’s information is returned with no effect on the currently 
configured country. 

On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59- 
If the carry is dear, DS:DX points to the information table. 

The following code segment illustrates a typical pattern for setting up the 
information table area. The code segment details the fields of the returned '.iforma* 


tion: 


C0UNTRYJTA8LE 

EQU 

THIS BYTE 

DATE_F0RMAT 

m 

0000 

CURRENCY_SYM 

DB 

S DUP{0) 

TH0USANDS_SEP 

DB 

00 


DB 

00 

DECIMAL_SEP 

DB 

00 


DB 

00 

0ATE_SEP 

DB 

00 


DB 

00 

TIME_SEP 

DB 

00 


DB 

00 

CURRENCY_FMT 

DB 

00 

CURRENCY_SD 

DB 

00 

T1ME_FMT 

DB 

00 

MAP_CALL 

DD 

03000000 

DATALIST_SEP 

OB 

CO 


03 

00 

% 

DB 

5 DUP(0) 


Numeric code 
ASCIIZ--zero terminated 
ASCIIZ--zero terminated 
this byte will be mil 
ASCIIZ--zero terminated 
this byte will be nul 
ASCIIZ-zero terminated 
this byte will be nul 
ASCII2--zero terminated 
this byte will be nul 
Numeric code 

Sig. decimals in currency 
0=normal, l=military 
Map call address 
ASCJIZ-zerc terminated 
this byte will be nul 
Reserved area 
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To use I hii* code segment, load DS:l)X with the segment offset ol COUNTRY table 
helore calling this service, On return, the information table is filled m and indi¬ 
vidual fields can be addressed by held name 

0ATE _ FMT >s a numeric code indicating the format to be used to display the date. 
Table 21.8 gives the possible values ‘or this field. Notice also that this field is one 
word long, which may indicate significant expansion in future versions of DOS 


Table 2 

1.8. Date-format codes and their meanings. 

Code 

Date Format 

Country Affiliation 

0 

mm dd yy 

l : nited States 

1 

dd mm yy 

Europe 

2 

yy mm dd 

Japan and the Ear East 


Now. refer again to the code segment. CURRENCY_sym is a null-terminated string 
that indicates the currency symbol for the country. This symbol can be no more than 
four characters long because the last character has a value of 0 (thus the designation 
null-terminated . or ASCllZ string) 

THOUSANDS_SEP. DECIMAL_SEP. DATE_SEP. TIME_SEP. and DATAIIST_SEP also are 
ASCIIZ strings. They indicate, respectively, the characters to be used to separate 
thousands in number displays, to indicate the decimal point, to separate date 
components, to separate time components, and to separate items in a data list. Each 
field is two bytes long, with the second byte set to nul. Why the writers of DOS felt 
that a single-byte string needed to be set up as an ASCIIZ string b a mystery. 

CURRENCY_FMT is a numeric code indicating the format to be used to display the 
currency. Table 21.9 gives the possible values for this field. 


Table 21.9■ Currency format codes and their meanings. 

Code Meaning 

0 Currency symbol immediately precedes currency value 

1 Currency’ symbol immediately follows currency value 

2 Currency symbol and space immediately precede currency 
value 

3 Currency symbol and space immediately follow currency 
value 

4 Currency symbol replaces decimal separator 
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CfRRENCY_SO indicates the number of significant 


decimal places in the country's 


currency displays. 

Bit 0 of TIME.FMT indicates 
bit 0 is 0, a 12-hour clock is used. 


how the hours of a time display arc handled. If 
If bit 0 is 1. a military (or 24-hour) clock is used. 


map call is the full segment :offset address of a DOS subroutine that converts 
foreign ASCII lowercase characters to their uppercase equivalents. Thu-rouune is 
intended for ASCII codes with values greater than 7Fh. The original ASCII code is 
specified in AL; then this routine is called, and the converted ASCII code is returned 

in AL.. \ 

This service returns the country code in BX as well as the information in the 
country table This code is meaningful only i. you invoked the serv ice with AL set 
to 0 In this way. you can determi. the country for which the computet is 

configured. 


To set country-dependent mlormatiuii. simply load DX with FFFFh. the signal 
that jnlorms DOS that the country-dependent information is being set. You load AL 
with the country code (refer to table 21.7) to be retrieved. If the country’ code is 
greater than 255 (as for Finland and Israel), you enter FFh in AL and set BX to the 
country -code value. If AL is less than FFh, the contents of BX are not significant. 

On return, the carry flag indicates whetner an error has occurred. If the carry 
flag is set. AX contains die error code, which can be handled through service 21/59. 
If the carry is clear, no error has occurred and the contents of AX are not significant. 


* - SSS '1 -: ZZZXZ g2JB« 

Create Subdirectory (Interrupt 21h, service 39h) 

Category: Disk services 

\ 

Registers on Entry: 

AH: 39h 

DX: Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Error code 

Memory Affected: None 
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Syntax: 


PUSH 

CS 

;Code segment and 

POP 

OS 

; data segment are same 

uov 

OX,0 C FSET PATH_NAME 

;0ffset address of path 

IIOV 

; »H,39h 


I NT 

21h 

;DOS services interrupt 

JC 

ERROR 

;Carry set, handle error 


Description: This service (the opposite of service 21/3A) allows the creation of a 
subdirectory. The result is the same as the result of using the DOS MKD1R. or MD. 
command. On entry, DS:DX points to an ASC1I7. (null-terminated ASCII) string that 
contains the name of the directory. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX Service 21/59 can be used to get detailed error information. If the carry flag 
is not set, the operation was successful and AX is undefined. 


r , naggaBggsBBam 

Remove Subdirectory (Interrupt 21h, service 3Ah) 

Category': Disk services 
Registers on Entry: 


AH: 3 Ah 

DX: Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Error code 

Memory Affected: None 


Syntax 

• 

PUSH 

CS 

POP 

OS 

UOV 

DX,OFFSET PATH_NAME 

UOV 

AH,3Ah 

1NT 

21h 

JC 

ERROR 


;Code segment and 
; data segment are same 
;Offset address of path 

;DOS services interrupt 
;Carry set, handle error 


Description: This service (the opposite of service 21/39) is used to remove existing 
subdirectories. The result is the same as the result of using the DOS RMDIR. or RD, 
command. On entry, DS:DX points to an ASC1IZ (null terminated ASCII) string that 
contains the name of the director)'. 


643 
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mo is set an error has occurred and the error code is 
, n u„ ? d,o pc, del ailed error inform*,ion. If ,hc earn- Hag 

no, »e,. the opera,ion was successful and AX is undefined. 





Set Directory (Interrupt 21h, service 3Bh) 


Category’: Disk serv ices 
Registers on Entry: 

AH: 3Bh 

DX: Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Error code 


Memory Affected: None 

Syntax: 

PUSH CS 

POP DS 

MOV OX,OFFSET PATH_NAME 

MOV AH,3Bh 

INT 21 h 

JC ERROR 


;Code segment and 
; data segment are same 
;Offset address of path 

;DOS services interrupt 
-.Carry set, handle error 


Description: This service is used to change the default directory setting. The result 
is the same as that of using the DOS CHD1R, or CD, command. On entry, DS:DX 
points to an ASC11Z (null-terminated ASCII) string that contains the name of the 
directory. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be us~d to get detailed error information. If the carry flag 
is not set, the operation was successful and AX is undefined. 


railing g zazszss* 

Create File (Interrupt 21h, service 3Ch) 

Category*: Disk services 

Registers on Entry: 

AH 3Ch 

CX File attribute 
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DX: Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Return code 

Memory .Affected. None 

Syntax: 

PUSH CS 

POP DS 

UOV DX,OFFSET PATH_NAME 
MOV CX,0 

UOV AH,3Ch 

INT 21M 

JC ERROR 

MOV file_handle,ax 

Description: This service is used to create or truncate a disk file On entry. DS:DX 
points to an ASCIIZ (null-terminated .ASCII) string that contains the full name of the 

file, including any applicable path name CX is set equal to the desired attribute .or 
the file. 

This service is identical to sen-ice 21 '5B except that if the file name specified 

in the ASCIIZ string already exists, the file is opened and its length is truncated 
to 0. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. If the earn flag 
is not set. the operation was successful and AX contains the file handle for the ncwlv 
opened file. This number (file handle) can be used in many other DOS file 
operations. 

When this service is completed, the specified file is left open. You do not need 
to open the file but you must remember to close it. 


;Coae segment and 
; data segment are same 
;0ffset address cf patn 
;File attridute is normal 

;00S services interrupt 
:Ca^ry set, handle ermr 
;Store returned nancie 



Open File (Interrupt 21h, service 3Dh) 

Category: Disk services 

Registers on Entry: >. 

AH: 3Dh 

AC - - Open code 

DX: Offset address of path name 

DS: Segment address of path name 


6-4 
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Kf^i'ilcrs on Return: 

\\ l ile handle or error code 

Memory Affected: None 
o 

Syntax. 


OX.OFFSr.* PATH_NAME 
AL ■1 1 0000 ' Ob 
A«,3Dh 
2 1 r» 

ERROR 

file_handi.e ,ax 


-.Code segment and 
; data segment are same 
;0ffset address of patn 
;Set proper open mode 

;DOS services interrupt 
;Carry set, handle error 
;Save file handle 


MUV riLU i- 

^ «.*«. > 0 ^ -he ^ ***** <*** «*• ■** 

ha in Al has significance. Table 2110 gives detailed information. 

Table J J.JfA Open-mode bit settings for service 21/30. __ 


mis 

76543210 


Meaning _ 

File is inherited by a child process 
File is not inherited by a child process 
Sharing mode—allow compatible access 
Sharing mode—exclusive access 
Sharing mode—deny others write access 
Sharing mode—deny others read access 
Sharing m >d'-—allow others hill access 
Ke‘erv j—set to 0 
Open f' i read access 
(>pc:i for write access 
Open for read/write access 


On return, if the carry fag is set. an error has occurred and the error code is 

m AX Service 21/59 can be used to get detailed error information 1. the cany 

is nm ‘ ct. the operatu >n was successful and AX contains the file handle for the new > 
opened file This number (tile handle) can - be used in man) other DOS 
operations. 
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Close File (Interrupt 2lh, service 3Hh) 

Category: Disk services 

Registers on Entry: 

AH: 3 Eh 

BX: File handle 

Registers on Return: 

AX: Error code 

Memory Affected: None 

Syntax: 


MOV BX,FILE_HANDIE ;Get file handle 

MOV AH,3Eh 

INT 2lh ;D0$ services interrupt 

JC ERROR ;Carry set, handle error 

Description: This service closes a previously opened tile Th.* file handle must be 
loaded in BX. 

On return, if the carry flag is set. an error has occurred and the error code is 
in AX. Service 21''59 can be used to get detailed error information. If the earn flag 
is not set, the operation was successful. 


Read File (Interrupt 21h, service 3Fh) 

Category: Disk services 

Registers on Entry: 

AH: 3Fh 

BX: File handle 

CX-. Bytes to read 

DX: Offset address for buffer 

DS: Segment address for buffer 

Registers on Return: 

AX: Return code 

Memory Affected: The memory area specified by DS DX is overlaid with informa¬ 
tion read from the disk or other device, using a handle. 
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Syntax: 

MOV 6X,FILE_HANOLE 

PUSH cs 

POP DS 

MOV OX, OFFSET BUFFER 

MOV CX,1©00h 

MOV AH,3Ft1 

INT 21 h 

JC ERROR 


;Get file handle 
;Code segment and 
*. data segment are same 
;Offset address of buffer 
;flead 4K of info 


;D0S services interrupt 
•Carry set, handle error 

JC tnnun 

m .hi- input buffer CX is set to the number of lunes to be read. 

Information is read from the file, based on the 
file has lust been opened, reading starts a. the begmmng of the file. Subseque 
reads begin at the point at which the last read ended. 

On return, if the earn flag is set. an error has occurred ^ ‘he e.ror code ts 
in AX Sen ice '>1/59 can be used to get detailed error information. If the earn flag 
is not set the operation was successful and AX coma,ns the number of bytes read. 


tE 


Write File (Interrupt 21h, service **0h) 

Category: Disk services 

Registers on Entry: 

AH -»0h 

BX: File handle 

CX. Bvtes to write 

D\ Ollset address for buffer 

DS: Segment address for buffer 


Registers on Return: 
AX: Return code 


Memory' Affected: None 


Syntax 

• 

MOV 

BX,F1LE_HANDLE 

PUSH 

CS 

POP 

DS 

MOV 

OX.OFFSET BUFFER 

MOV 

CX,100Oh 


;Get file handle 
;Code segment and 
; data segment are same 
-.Offset address of buffer 
;Wnte 4K of info 


Scanned by CamScanner 




Chapter 21: The DOS Services 649 


PUSH 

CX 

;Save for later reference 

MOV 

AH,4Qh 


INT 

2th 

;D0S services interrupt 

JC 

ERROR 

;Carry set, handle error 

POP 

cx 

;Get oriflinal bytes back 

CMP» 

AX,CX 

;Are they the same? 

JNE 

ERROR* 

;No, go handle 


Description: This service writes information to a disk file or other device that can 
be assigned a file handle. The file handle is specified in BX. with DS:DX P 0 *" 1 "^ 
to the buffer area. CX is set to the number of bytes to be copied from the buffer to 

the disk. 

Writing is done based on the value of the file pointer. If the file has just been 
opened, writing begins at the front of the file. Subsequent * »tes begin at t e point 
at which the last write ended. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX Service 21/59 can be used to get detailed error information. If the carry ag 
is not set. the operation was successful and AX contains the number of oytes written. 
If AX does not equal the number of bytes that should have been written, an error 
(such as the disk being full) has occurred, even though the carry flag is not set 


Delete File (Interrupt 21h, service 41h) 

Category: Disk services 
Registers on Entry: 


AH: 

41h 


DX: 

Offset address of path name 

DS. 

Segment address of path 

name 

Registers on Return: 


AX: 

Error code 


Memory Affected: None 


Syntax: 


PUSH 

CS 

;Ccde segment and 

POP 

OS 

; data segment are same 

MOV 

DX,OFFSET PATH_NAME 

;Offset address of path 

MOV 

AH,41h 


INT 

2th 

;D0S services interrupt 

JC 

ERROR 

[Carry set, handle error 
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Description: This service deletes a disk Tile. On entry. DS.DX points to an ASU»2 
(null-terminated ASCII) string that contains the full name of the file, including any 
applicable path name. Wild cards cannot be used in the file designation. If the f:>e 
being deleted has a read only attribute, this service returns an error. 

On return, if the earn flag is set. an error has occurred and the error code is 
in AX. Seri re 21/59 can be used to get detailed error information. If the earn - flag 
is not set. the operation was successful. 



Move File Pointer (Interrupt 21h, service 42h) 

Category: Disk services 

a* 

Registers on Entry*: 

AH: 42h 

AL: Movement code 

UX; file handle 

CX: High-order word of distance to move 

DX: Low-order word of distance to move 

• • 

Registers on Return: 


AX: Low-ordcr word of new pointer location or error code 

DX: High-order word of new pointer location 

e’ 

Memory* Affected: None 


Syntax: 

MOV BX,FILE_HANOLE 
MOV AL,0 

MOV CX.DISTJUGH 
MOV DX.DISTJ.OW 
MOV AH.42h 

INT 21h 

JC ERROR 


;Get file handle 
;Relative to start of file 
;Distance to move 


;D0S services interrupt 
;Carry set, handle error 


Description: This service causes the file pointer to move to a new location. The file 
handle if specified in UX. and the distance to move (in bytes) is specified in CX:DX. 
A m* vvment code is specified in AL (sec table 21.11). 
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Table 21.11. Movement code for service 21142. 

Value 

Meaning 

0 

Move relative to beginning of file 

1 

Move relative to current pointer location 

2 

Move relative to end of file 


If the offset specified in CX:DX is large enough, you can move the file pointer 
past the beginning or the end of the file. Doing so does not generate an immediate 
error but does cause an error’when reading or writing is attempted later. 

On return, if the carry flag is set. an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. If the carry flag 
is not set. the operation was successful and DX AX contains the new file-pointer 
value. 


Get/Set File Attributes (Interrupt 21h. service 43h) 

Category: Disk services 

Registers on Entry: 

AH: 43h 

AL: Function code 

CX: Desired attributes 

DX. Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Error code 

CX: Current attributes 


Memory Affected: None 
Syntax: 


MOV 

AL ,0 

;Get current attributes 

PUSH 

CS 

;Code segment and 

POP 

OS 

; data segment are same 

MOV 

DX,OFFSET PATH_NAME 

•.Offset address of PATH 

MOV 

AH,43h 


IHT 

2th 

iDOS services interrupt 

JC 

error 

;Go handle error 
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Description: This sen ice enables you to determine or set a file's attributes The 
desired funct, on is specified in AL If AL=0. the file attributes arc retneved: .f AL= 1. 
the file attributes are set. 


DS:DX should point to an ASC11Z (null-terminated ASCII) string that contains 
the full name of the file, including any applicable path name. Wild cards cannot be 
used in the file designation. If you arc setting the file attribute (AL^l). place the 
desired value in CN Because the file attribute is only one byte long, the new setting 
is placed in CL. and CH is set to 0. Table 21.12 shows the possible file-attribute 
settings. In this table, a 1 in a bit position indicated by an x means that the attribute 
is selected; a 0 means that the attribute is not selected. 


Table 21.12. Bit settings for file attributes, service 21 /43- 


Bit 

76543210 Meaning 


00 

Resened—set to 0 


X 

Archive 


0 

Subdirectory—set to 0 for this sen-ice 


0 

Volume label—set to 0 for this sen-ice 


X 

System > 


X 

Hidden 

' 

X 

Read-only 



You cannot change the volume-label or subdirectory bits of the file attribute 
byte. If you attempt to do so. or if these bits are not set to 0, an error is generated. 
If you are retrieving the file attributes (AL=0). the contents of CX arc not significant. 

On return, if the earn flag is set. an error has occurred and the error code is 
in AX. Sen-ice 21/59 can be used to get detailed error information. If the carry flag 
is not set. the operation was successful. If you were retrieving the file attribute. CX 
contains the requested information. 


Get Device Information (Interrupt 21h, 
service 44h, function OOh) 

Category: System sen-ices 
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Registers on Entry: 

AH: 44h 

AL: OOh 

BX: Device handle 

Registers on Return: 

DX: Device information 

Memory Affected: None 

Syntax: 


MOV 

AL,0 



MOV 

BX,OEVICE_HANDLE 

;Use 

this handle 

MOV 

AH,44h 



INT 

21h 

;D0S 

services interrupt 


Description: This function retrieves information about the device or file repre* 
sented by a file handle. On calling. AL should contain 0 and BX should contain the 
device handle. On return. DX contains the requested information (see table 21.13). 

Table 21.13 • Device information returned by function 21/44/0. 

Bits 

FEDCBA98 76543210 Meaning 

? 

0 

1 

?????? 

0 

1 

e 

1 

xxxxxx 

0 

1 


Reserved 

Control strings not allowed for services 
21/44/2, 21/44/3. 21/44/4, and 21/44/5. 

This bit is significant only if bit 7 is 1. 

Control strings acceptable for services 
21/44/2. 21/44/3. 21/44/4, and 21/44/5. 

This bit is significant only if bit 7 is 1. 

Reserved 

This channel is a disk file. 

This channel is a device. 

File has not been written to (if device is a file) 
File has been written to (if device is a file) 
Drive number (if device is a file) 

End-of-file returned if device is read 
End-of-file not returned if device is read 


continues 
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Table 21 . Li- continued 


bits 

FE0C8A98 76543210 


0 

1 


0 

1 


0 

1 


0 

1 


0 

1 


0 

1 


Meaning 


Using ASCII mode 
Using binary mode 
Not a special device 
Special device 
Noe a clock device 
Clock device 
Normal device 
Null device 

Noi console output device 
Console output device 
Not console input device 
Console input device 


This function is not supported on network devices. 


f t '. raiku&'riJa .fr-iTi a, '^nii 1 ■■ 

Set Device Information (Interrupt 21h, 
service 44h, function Olh) 

Category': Svstcm services 

Registers on Entry: 

AH: 44h 

AL: Olh 

BX: Device handle 

DH: 0 

DL: Device informal ion 

Registers on Return: l nehanged 
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Memory Affected: None 
Syntax: 


MOV 

AL, 1 



MOV 

DH,0 

• 

( 

;Must be set to 0 

MOV 

DL,DEVICE. 

.INFO 

;Desirea configuration 

MOV 

ox, device] 

.HANDLE 

;For tms device 

MOV 

AH,44h 



INT 

2lh 


;D0S services interrupt 


Description: This function is used to set information about the device. On calling, 
AL should contain l. BX should contain the device handle, and DL should cc main 
the device information (see table 21.1-i). DH must be set to 0. 


Tabic 21.14. Device information for function 21/44/1. 

Bits 

. 

76543210 

Meaning 

1 

Must be set to 1: indicates this channel is a device 

0 

End-of-file returned if device is read 

1 

tnd-of-file not returned if device is read 

0 

Using ASCII mode 

1 

Using binary mode 

0 

Not a special device 

1 

Special device 

0 

Not a clock device 

1 

Clock device 

0 

Normal device 

1 

Null device 

e 

Not console output device 

i 

Console output device 

• e 

Not console input device 

i 

Console input device 


This function is not supported on network devices. 
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Character Device Read (Interrupt 21h, 
service 44h, function 02h) 

Category: System services 

Registers on Entry': 

AH: 44h 

AL: 02h 

BX: Device handle 

CX: Bytes to read 

DX: Offset address of buffer 

DS: Segment address of buffer 


Registers on Return: 

AX: Bytes read 

Memory’ Affected: The buffer area at DS:DX is overwritten with information read 
from the device driver. 


Syntax: 

PUSH CS 
TOP OS 

MOV OX,OFFSET BUFFER 
MOV AL.2 

MOV BX,DfVICE_HANDLE 
MOV CX,NUM_9VTES 
MOV AH,44h 
INT 21h 


;Code segment and 
; data segment are same 
;Address of input buffer 

;Want this device 
;Read this many bytes 

;D0S services interrupt 


Description: This function reads a control string from the device. The buffer 
specified by DS:DX stores the information from device BX. Only CX bytes are read 
from the device. 

For this function to be usable, bit 14 of the device-information word (as 
returned in the DX register through service 21/44/0) must be 1. (Refer to table 21.13 
for the makeup of the device-information word.) This service is not supported on 
network devices. 
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Character Device Write (Interrupt 21h, 
service 44h, function 03h) 

Category: System services 


Registers on Entry: 

AH: 44h 

AL: 03h 

BX: Device handle 

CX: Bytes to write 

DX: Offset address of buffer 

DS: Segment address of buffer 

Registers on Return: 

AX: Bytes written 

Memory Affected: None 

Syntax: 


PUSH CS 

POP DS 

MOV OX,OFFSET BUFFER 

MOV BX.DEVICE.HANDLE 

MOV CX,NUM_BYTES 

PUSH CX 

MOV AL,3 

MOV AH,44h 

INT 21h 

POP QX 

CMP AX,CX 

JNE ERROR . 


;Code segment and 
; data segment are same 
•.Address of input buffer 
;Want this device 
;Write this many bytes 
{Store for later check 


;DOS services interrupt 
;Get back original number 
;Was everything written? 
;No, go handle 



Description: This function writes a control string to a device. CX bytes of informa¬ 
tion stored at the buffer address specified by DS:DX are written to device BX. 


For this function to be usable, bit 14 of the device-information word (as 
returned in the DX register through service 21/44/0) must be 1. (Refer to table 21.13 
for the makeup of the device-information word.) This service is not supported on 


network devices. 
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Block Device Read (Interrupt 21h, 
service 44h, function 04h) 


Category: System services, 

Registers on Entry: 

• 

AH: 44h 

AL: 04h 

BL: Drive number 

CX: Bytes to read 

DX: Offset address of buffer 

DS: Segment address of buffer 

Registers on Return: 

AX: Bytes read 

Memory Affected: The buffer area at DS:DX is overwritten with information read 

from the drive. 

Syntax: 

PUSH CS ;Code segment and 

POP OS ; data segment are same 

MOV ox,OFFSET BUFFER ;Addrass of input buffer 

MOV AL,4 

MOV BL,DRIVE ;Want thia driva 

MOV CX,NUM_BYTES ;Read this many bytes 

MOV AH,44h 

INT 21 h ;DOS servicas interrupt 

Description: This functionreadsacontrolstringfromablockdevice, typically a disk 
drive. BL is used to specify which drive to use, where 0=default, 1=A, 2-B, 3-C, 
etc. The information is stored at the buffer specified by DS:DX. Only CX bytes are 
read. 

For this function to be usable, bit 14 of the device-information word (as 
returned in the DXriregister through service 21/44/0) must be 1. (Refer to table 21.13 
for the makeup of the device-information word.) This service is not supported ou 
network devices. 
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Block Device Write (Interrupt 21h, 
service 44h, function Q5h) 

Category: System services 

Registers on Entry: 

AH: 44h 

AL: 05h 

BL: Drive number 

CX: Bytes to write 

DX: Offset address of buffer 

DS: Segment address of buffer 

Registers on Return: 

* ‘ * * > . 

AX: Bytes written 

JtL 

Memory Affected: None 
Syntax: 

PUSH CS {Code segment and 

POP DS ; data segment are same . 

MOV OX.OFFSET BUFFER ‘ ;Address of input buffer 

MOV BL,DRIVE ;Want this drive 

MOV ex.NUM.BYTES ;Write this many bytes 

PUSH CX {Store for later check 

MOV AL.5 

MOV AH,44h 

INT 21h {DOS services interrupt 

POP CX ;6et back original number 

CMP AX,CX {Was everything written? 

JNE ERROR ;No, go handle 

Description: This function writes a control string to a block device, typically a disk 
drive. BL is used to specify which drive to use, where 0=default, 1=A, 2=B, 3=C, 
etc. CX bytes of information stored at the buffer address specified by DS:DX are 
written. 

For this function to be usable, bit 14 of the device-information word (as 
returned in the DX register through service 21/44/D) must be 1. (Refer to table 21.13 
for the makeup of the device-information word.) This service is not supported on 
network devices. 
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Get Input Status (Interrupt 
service 44h, function 06h) 


21h, 


Category: Svsicm services 


Kegisters on Entry: 

AH: 44h 

AL: 06h 

BX: Device handle 

Registers on Return: 

AL: Status 

Memory Affected: None 

Syntax: 

MOV- BX,DEVICE_HAN'DLE ;Use this device 

MOV AL,6 
MOV AH,44h 

jnt 21 h ;00S services interrupt 

Description: This service determines whether the device is ready for input. If the 
device is ready, AL returns OFh. If the device is not ready, AL returns 0. 

If the device specified in BX is a file, AL always returris FFh until the end-of-file 
is reached, at which point AL is equal to 0. 

This function is not supported on network devices. 


Get Output Status (Interrupt 21h, 
service 44h, function 07h) 

Category: System services 

Registers on Entry: 

AH: 44h 

AL: 07h 

BX: Device handle 

Registers on Return: 

AL: Status 
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Memory Affected: None 
Syntax: 

MOV BX.OEVICE.HANDLE ;U3* this device 

MOV Al,7 
MOV AH,44h 

INT 21h ;D0S services Interrupt 

Description: This service determines whether the device is ready for output. If the 
device is ready, AL returns OFh. If the device is not ready, AL returns 0. 

If the device specified In BX is a file, Al. always returns FFh until the end-of-file 
is reached, at which point AL is equal to 0. 

This function is not supported on network dev :es. 


Block Device Changeable? (Interrupt 21h, 
service 44h, function 08h) 

Category: System services 
Registers on Entry: 


AH: 

44h 

AL: 

08h 

BL: 

Drive number 

Registers on Return: 

AX: 

Status 


Memory Affected: None 


Syntax: 


MOV 

BL,® 

;Check on default drive 

MOV 

AL|8 


MOV 

AH,44h 


INT 

2lh 

;D0$ services interrupt 

CMP 

AX, 1 

;Is it fixed? 

JE 

FIXED 

;Yes, so treat accordingly 


Description: This function (not available before DOS version 3 0) enables your 
program to determine whether the block device (typically a disk drive) supports 
removable media. BL is used to specify which drive to check (0=de£ault, 1 =A, 2-B, 
5=C, and so on). 
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A V Jc ^nnal to 0 if removable media is supported, and equal to 1 If 
,hc removable (fixed disk). If AX is equal .o OFh. .he value specified « 

BL is an invalid drive. 

This function is not supported on network devices. 


Logical Device Local/Remote Determination 
(Interrupt 21h, service 44h, function 09h) 

Category: Network services 

Registers on Entry: 

AH: 44h 

AL: 09h 

BL: Drive number 

Registers on Return: 

DX: Status 

Memory Affected: None 

Syntax: 

MOV bl, 0 ;Check on default drive 

MOV AL,9 
MOV AH,44h 

INT • 21h ;00S services interrupt 

Description: This function (not available before DOS version 3.1) is used in a 
networking environment to determine whether the block device (usually a disk 
drive) specified in BL is local or remote. BL is used to specify which drive to check 
(Oadefault, 1=A, 2«B, 3®C, and so on). 

' 

On return, bit 12 of DX is set if the device is reniote/lf the device is local or If 
redirection is paused, bit 12 is clear. If bit 12 is clear, the bits in DX will have the 
meaning listed in table 21.15. 
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Table 21.15 . Status value returned by service 21/44/09 . 

Bits 

FEDCBA9B 76543210 

Meaning 

0 

Drive is not substituted 

1 

Drive is substituted for anocher drive 

e 

Drive may not work with services 44/04 and 

- 

44/05 

i 

Drive will work with .■crvices 44/04 and 44/05 

• 

Media descriptor byte in F.VT not required 

i • 

Media descriptor byte in FAT required 


Unused; set to 0 

6 

Drive may not work with service 44/08 

1 

Drive will work with service 44/08 

• 

Unused; set to 0 

6 

Drive is local 

1 

Drive is local, but shared by other network 

e 

computers 

Unused; set to 0 

• 

Drive may not work with service 44/11 

i 

Drive will work with service 44/11 

• 

Drive may not work with services 44/OD, 

i 

44/OE, and 44/OF 

Drive will work with services 44/OD, 44/OE, 


and 44/OF 

• 

Unused; set to 0 

• 

Unused; set to 0 

e 

Unused; set to 0 

• 

Unused; set to 0 

• 

Drive uses 16-bit sector addressing 

. i 

Drive uses 32-bit sector addressing 

• 

Unused; set to 0 
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Handle Local/Remote Determination 
(Interrupt 21h, service 44h, function OAh) 

Category: Network services 

Registers on Eatry: 

AH: 44h 

AL: OAh 

BX: File handle 

Registers on Return: 

DX: Status 

Memory Affected: None 

Syntax: 

MOV BX,FILE_HANDLE jCheckinfl this file 

MOV AL.OAh 

MOV AH,44h 

INT 21h ;DOS services interrupt 

Description: This function (not available before DOS version 31) is used in a 
networking environment to determine whether a given file handle (specified in BX) 
represents a local file or a remote one. 

On return, bit 15 of DX is set if *he device is remote. If the device is local, bit 
15 is clear. The meaning of the rest of the bits depends on whether the handle refers 
to a file or not. Table 21.16 shows the bit meanings returned in DX if the handle 
represents a file; table 21.17 indicates the bit meanings if it is not a file. 


Table 21.16. Device information relumed by function 21/44/OA, if device is a 
file (bit 7 is set). 

Bits 

FE0CBA98 7654321® Meaning 

0 Local file 

1 Remote file 

* Date/time is set when file is closed. 

1 Date/time is not set when file is closed. 

7 Reserved 

® Inheritable 

Not inheritable 
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Bits 

FEDC8A98 76543210 

Meaning 

?????? 

Reserved 

0 

This device is a disk file. 

0 

File has been written to 

1 

File has not been written to 

xxxxxx 

Drive number (if device is a file) 


Table 21.17. Device information returned by function 2H44/0A, if device is not 
a file (bit 7 is dear). 

Bits 

FE0CBA98 

76543210 

Meaning 

0 


Local device 

1 


Remote device 

7 


Reserved 

l 


Named pipe 

0 


Inheritable 

1 


Not inheritable 

1 


Network spooler 

77? 


Reserved 


1 

This channel is a device. 


• 

End-of-fUe returned if device is read 


1 

End-of-file not returned U device is read 


0 

Using ASCII mode 


1 

Using binary mode 


0 

Not a special device 

• 

1 

Special device 


0 

Not a clock device 


1 

Clock device 


0 

Normal device 


1 

Null device 


• 

Not console output device 


1 

Console output device 


0 

Not console input device 


1 

Console input device 
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Set Sharing Retry Count (Interrupt 21h, 
service 44h, function OBh) 

Category: System services 

Registers on Entry: 

AH: 44h 

AL: OBh 

CX: Delay loop counter 

DX: Retries 

Registers on Return: 

AX: Error code 

Memory Affected: None 

Syntax: 


MOV 

CX,3 

;3 delay loops 

MOV 

OX ,8 

;8 retries 

MOV 

AL,OBh 


MOV 

AH,44h 


INT 

21 h 

;D0S services interrupt 

JC 

ERROR 

;Error, go handle 


Description: This function (not available before DOS version 3-0) is used in a 
networking environment to specify the number of attempts at file access and the 
delay between retries. If a file is locked or if a sharing conflict exists, DOS attempts 
to access the file three times, with one delay loop between attempts, before 
returning an error. 

On return, the carry flag indicates an error if one has occurred, if the cany flag 
is set, AX contains the error code, which can be handled through service 21/59- 



Handle Generic Code-Page Switching 
(Interrupt 21h, service 44h, function OCh) 

Category: System services 


Registers on Entry: 

AH: 44h 

Al.: OCh 

BX: Device handle 
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CH: Major subfunction code 

CL: Minor subfunction code 

DX: Offset address of parameter block 

DS: Segment address of parameter block 

Registers on Return: 

AX: Error code 

Memory Affected: This function can have various effects on memory, depending on 
the major and minor subfunctions requested. 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

DS 

; data segment are same 

MOV 

DX,OFFSET PARM_BL0CK 

;Address of parameter block 

MOV 

BX,DEVICE_HANDLE 

;Device handle in use 

MOV 

CH,MAJOR 

.Major subfunction desired 

MOV 

Cl,MINOR 

;Minor subfunction desired 

MOV 

Al.OCh 


MOV 

AH,44h 


INT 

21h 

;D0S services interrupt 


Description: This service (not available in this form before DOS 3 3) allows device- 
driver support for subfunctions that enable code-page switching. You specify the 
device handle in BX, a major subfunction code in CH, and a minor code in CL. 
Currently, the service has four major codes and five minor codes, for a total of 20 
possible combinations of major/rainor codes. Each minor code requires a different 
set of parameters, which are passed through a parameter block pointed to by DS:DX. 

On return, the cam' flag indicates an error if onp has occurred. If the carry flag 
is set, AX contains the error code, which can be handled through service 21/59. 

Because of the detail and complexity involved with this function, its discussion 
is best left to another publication. Detailed information about this function, its 
subfunctions, and the parameter setup is beyond the scope of this book. 



Generic IOCTL Block Device Request 
(Interrupt 21h, service 44h, function ODh) 

Category: System services 
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Registers on Entry 2 


AH: 44h 

AL: ODh 

BL: Drive number 

CH: Major subfunciion code 

CL: Minor subfunciion code 

DX: Offset address of parameter block 

DS: Segment address of parameter block 

Registers on Return: 

AX: Error code 

Memory Affected: This function can have various effects on memory, depending 
on the major and minor subfunciions requested. 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

OS 

; data segment are same 

MOV 

DX,OFFSET PARM_8L0CK 

;Address of parameter block 

MOV 

BL.O 

;Check on default drive 

MOV 

CH,8 

;Always 8 • 

MOV 

CL.MINOR 

;Minor subfunction desired 

MOV 

AL,ODh 

• 

MOV 

AH,44h 


1NT 

2in 

;DOS services interrupt 


Description: IOCTT. is a contraction for input-output control. This service (not 
available before DOS version 3.2) allow*, uniform device support for a number of 
block device functions ty pica II). disk drive functions. The drive number is speci¬ 
fied in BL (0=default, 1=A, 2 = b. 3=C, and so on). 


A major subfunction code is specified in CH, which is always 8 (as of DOS 3.3). 

A minor subfunction code is specified in CL. Table 21.18 details the minor codes 
possible. 


Table 21.18. Minor subfunction codes (CL) for service 21/44/OD. 
Value Meaning 


40h 

4lh 

42h 

46h 

60h 


Set device parameters 
Write logical device track 

Format and verify logical device track 
Set media ID 

Get device parameters 
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Value 

Meaning 

- 

61h 

Read logical device track 


62h 

Verify logical device track 


66h 

Get media ID 


o8h 

Sense media type 



Each minor code requires a different set of parameters, which are passed 
through a parameter block pointed to by DS.DX. 

On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59. 

Because of the detail and complexity involved with this function, its discussion 
is best left to another publication. Detailed information about this function, its 
suDfunctions. and the parameter setup is beyond the scope of this book. 


Get Logical Device Map (Interrupt 21h, 
service 44h, function OEh) 

Category: System services 
Registers on Entry: 


AH. 

44h 

AL: 

OEh 

BL: 

Drive number 

Registers on Return: 

AX: 

Return code 


Memory Affected: None 


Syntax 

• 


MOV 

BL,® 

;Use default drive 

MOV 

AL.OEh 


MOV 

AH.44H 


INT 

21 h 

;DOS services interrupt 


Description: This function (not available before DOS veision 3 2) determines 
whether a block device (typically, a disk drive) has more than one logical drive 
assigned to it. Use BL to specif)'which drive to check (0=default, 1=A, 2=B, 3=C, 
and so on). 
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On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set. AX contains the error code, which can be handled through service 21/59. 
!! the carry flag is not set. Al. contains the result code. If AL is 0, only one logical drive 
is assigned to the block device. If AL contains another number, that number 
represents the drive letter last used to reference the device. In this case, 1 =A, 2=B, 
3=C, etc. 


Set Logical Device Map (Interrupt 21h, 
service 44h, function OFh) 

Category: System services 

Registers on Entry: 

All: 4-ih 

AL: OFh 

BL- Drive number 

Registers on Return: 

AX: Return code 

Memory .Affected: None 

Syntax: 

MOV BL,0 

MOV AL,OFh 
MOV AH,44h 
INT 21h 

D« St ription This function (not available before DC version 3.2) assigns a logical 
drne -etter to a block device (typically a disk drive). I e BL to specify the drive lener 
(1 “A. ^ -B..^ b C, and soon). You use this function wl :n more than one logical drive 
letter can he assigned to a single physical block devil . An example is a syste* i with 
a single flopp> drive Even though the system has on one block device (the floppy 
drive), that device can be addressed logically as two -vices (drives A: and B ) This 
lunction causes Dt >S to view the system as either A: or B: in subsequent I/O functions. 

On return, the cirry flag indicates whether an error has occurred. If the carry 
flag is set. AX contains the error code, which can be handled through service 21/59. 


;Use default drive 


;D0S services interrupt 
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Query Handle (Interrupt 21h, service 44h, function lOh) 

Category: System services 


Registers on Entry: 

AH: 44h 

AL: 10h 

BX: Handle number 

CL: Minor subfunction code 

CH. Category 

Registers on Return: 

AX: Error code (if carry flag set) 

Memory Affected: None 

Syntax: 

MOV BX,Device_Han<Jle ;Use default drive 

MOV CL,65h function checking: Get iteration 

MOV CH,0lh ;Serial device 

MOV al, 10h 

MOV AH,44h 

INT 21h ;00S services interrupt 

Description: This function is used to determine whether a specific device supports 
IOCTL services. IOCTL is a contraction for input-output control. CL should contain 
the category number (1= serial device, 2=console, 3=parallel printer), and CH 
should contain the Interrupt 21/44/OC subfunction to check (45h or 65h). 

On return, the carry flag will be dear if IOCTL is supported; otherwise, it will 
be set. If the carry flag is set, AX contains the error code, which can be handled 
through service 21/59. 



Query Drive (Interrupt 21h, service 44h, function llh) 

Category: System services 

Registers on Entry: 

AH: 

AL: 

BL: 

CL. 

CH: 


44h 

llh 

Drive number 

Minor subfunction code 

08h 
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Registers on Return: 

AX: Error code (if carry flag set) 

Memory Affected: None 
Syntax: 

MOV BX,Oevice_Handle ;Use default drive 

MOV CL,65h ;Function checking: Get iteration 

MOV CH,68h ;Sense media type 

MOV AL,11h 

MOV AH,44h 

INT 2ih ;D0S services interrupt 

Description: This function is used to test whether a specific drive can support 
IOCTL services. lOCTL is an acronym for input-output control. When using this 
service, CL should be loaded with an Interrupt 21/44/01 subfunction to test. Table 
21.19 lists valid values for CL. 


Table 21.19. Minor sub/unction codes (CL) for service 21/44/11. 

Value 

Meaning 

40h 

Set device parameters 

41h 

Write logical device track 

42h 

Format and verify logical device track 

46h 

Set media ID 

60h 

Get device parameters 

61h 

Read logical device track 

62h 

Verify logical device track 

66h 

Get media ID 

68h 

Sense media type 


On return, the carry flag will be clear if IOCTL is supported; otherwise, the 
carry flag will be set. If the carry flag is set, AX contains the error code, which can be 
handled through service 21/59. 
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Duplicate File Handle (Interrupt 21h, service 45h) 

Category: Disk services 

Registers on Entry: 


AH: 

BX. 


•*5h 

File handle 


Registers on Return: 

AX. Return code 
Memory Affected: None 
Syntax: 


•Use current file handle 


;DOS services interrupt 
;Go handle error 
.Save new handle 


MOV BX,FILE_HANDLE_1 

MOV AH,45h 

INT 2th 

JC ERROR 

MOV FILE_HANDLE_2,AX 

Description: This service, which duplicates a file handle, results in two handles that 
point to the same file at the same file position. 

There is no clear need or use for this function; you simply can use two diff- 
erent handles to refer to a single fde. These handles operate in undent no, 
b ,,, use anv change you make to the file pointe. by using one of the 

handles is reflected in the other handle. The most common use for this function is 
with setvice 21/46. where you duplicate a handle before reassigning This use 

allows redirection later. 

~ nirn rhe carry flae indicates whether an error has occurred. If the carry 
flag is re, «Tonums^ -or code, which can be handled through service 21/59. 


Force Handle Duplication (Interrupt 21h, service 46h) 

Category: Disk services 
Registers on Entry: 


AH. 46h 

BX. File handle 

CX: File handle to be forced 
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Part IN' Reference 


Registers on Return: 
AX. Error code 


Memory Affected: None 


Syntax: 

MOV BX,FILE_HANOLE 

MOV CX,4 

MOV AH,46h 

INT 21 r. 

JC ERROR 


.'Original handle 
;Standard printer handle 

;00S service? interrupt 
;Branch if error 


Description: This service forces one file handle to point to the same device (file, for 
example) as another handle Jn the syntax example. BX represents an open file. CX 
is loaded with the standard printer handle, and through this service, handle 4 is 
made to point to the open file. Anything sent to handle -* (normally sent to the 
printer) is sent to the open file. 

On return, the carry flag indicates whether an error has occurred. If the cany 
flag is set. AX contains the error code, which can be handled through service 21/59 



Get Directory Path (Interrupt 21h, service 47h) 

Category: Disk services 

Registers on Entry: 

AH: 47h 

DL. Drive number 

SI: Offset address of buffer area 

DS: Segment address of buffer area 

Registers on Return: Unchanged 

AX. Error code 

SI: Offset address of buffer area 

DS: Segment address of buffer area 

Memory Affected: The memory area pointed to by DS:SI is overwritten with the 
requested directory information. 


Syntax: 


PUSH CS 

POP DS 

MOV SI, OFFSET OIR_BUFFEB 

;Code segment and 
; data segment are same 
;Address of 64-byte buffer 
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MOV 

DL ,0 

;Use default drive 

MOV 

AM,47h 


1NT 

2lh 

;D0S services interrupt 


Description: This service determines the ASCUZ-string path for the current direc- 
- tory of the drive specified in DL. where 0=delault, 1 =A, 2 = B, 3=C. etc. 

The returned string is not the complete path name because the drive designa¬ 
tor and root-directory backslash are not returned. These characters can be added 
to the beginning of the string, however, to create a complete path for the directors'. 
Because an ASCII7. string is returned, the returned string ends with an ASCII 0 
(nul). 

Because path names can be up to 64 bytes long, a good practice is to ma ( ke«. 
sure that the buffer area to which DS:Sl points is 64 bytes long. 

On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set. AX contains the error code, which can be handled through service 21 59 
If the carry flag is not set. the address to which DS:SI points is the start of the returned 
ASCUZ string. 


Allocate Memory (Interrupt 21h. service 48h) 

Category: System services 
Registers on Entry: 

AH 48h 

BX Paragraphs to allocate 

Registers on Return: 

AX: Return code 

BX: Maximum paragraphs available 

Memory Affected: Although the contents of the requested memory are not 
changed, the amount of free memory is reduced by the requested number of 
paragraphs 

Syntax: 

MOV BX,i0On -.Request 4K block of memory 

MOV AH,48h 

1NT 2ih ,90$ services interrupt 

JC ERROR :Branch if error 

MOV BLOCK SEO,AX ;Save segment address 
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Description: This service is used to set aside blocks of memon lor program use 
You specify the number of contiguous paragraphs required in 13X 

On return, the earn' flag indicates whether an error has occurred If rhe carry 
flag is set, AX contains the error code, which can be handled through service 21 '59 
If an error has occurred. BX contains the maximum number of contiguous para- 
graphs available. 

If the carry flag ir not set. AX points to the paragraph or segment address 
where the memory block begins. This memory block must later be freed (before 
program completion) through service 21 /h 9 


- ..1 * -' -r 


Free Allocated Memory (Interrupt 21h, service 49h) 

Category: System services 
Registers on Entry: 

AH: 49h 

ES: Segment address of memory block 

Registers on Return: 

AX: Error code 

Memory Affected: Although the contents of the requested memory are not 
changed, the amount of free memory is increased bv the size of the block being 
relinquished. 

Syntax: 

PUSH ES ;Save current segment 

MOV ES,BLOCK_SEG ;Set to segment to free 

MOV AH,49h 

INT 21h ;00S services interrupt 

POP ES ;Get register back 

JC ERROR ;Branch if error 

MOV BiOCK_SEG,0 .Zero out variable 

Description: This service frees memory blocks allocated through service 21/48. 
You specify the segment address of the block in ES. 

On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set. AX contains the error code, which can be handled through service 21/59. 
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Change Memory-Block Allocation 
(Interrupt 21h, service iAh) 

Category: System services 


Registers on Eotry: 

AH 4 Ait 

BX: Total paragraphs to allocate 

ES: Segment ao’dress of memory block 

Registers on Return: 


AX: 

BX 


Error code 

Maximum paragraphs available 

Memory Affected: Although the contents uf the requested mernorv are net 
changed, the amount of tlVee memory is reduced bv the difference between the 
number of paragraphs alrea dy allocated to the block and the requested number of 
paragraphs. 

Syntax: 


MOV BX,280h 

MOV AH,4Ah 

INT 21 h 

JC ERROR 

MOV BLOCK_SEG,AX 


, Change to 8K block 

;DC.*> services interrupt 
;Brat.'Ch if error 
;Save segmont address 


Description: This service changes the si 2 ,« of a memory block previously allocated 
through service 21/48. You specify the segment address of the existing block in ES. 

On return, the carry flag indicates whether an error has occurred If the carry 
flag is set. AX contains the error code, which ca/i be handled through serv ice 21 59 
If an error has occurred and an increase in block s izc was requested. BX contains the 
maximum number of contiguous paragraphs available, the original block allocation 
is not changed, however. 



Load Program (Interrupt 21h, service 4Bih, function OOh) 


Category: System services 

Registers on Entry: 

AH: 4Bh 
AL: OOh 


677 
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MX i )||s«m address of parameter block 
DX vllfset address of path name 
US Segment address ot path name 
I Sec mem address of parameter block 

Registers on Return. 

AX Error c ode 

Memory Affected: The desired file if located, is loaded into memory, overwriting 
previous memory contents. 


Syntax. 


MOV 

AX, ?.S 

,Cooe segment is seme as 

MOV 

03. AX 

, data segment and 

MOV 

ES, AX- 

; extra segment 

MOV 

OX .OFFSET FILE.PATH 

{Offset address of petn 

MOV 

BX. OFT SET I.OAD.PAPMS 

.Offset address of pa'^eters 

MCV 

AL, <? 

;Loao only 

MOV 

AH 


I NT 

21 h 

;00S services interrupt 

Description: This service alio.vs 

a disk file to be loaded. DS.DX should point to 

an 

ASC II/ (null-terminated ASCII) string that contains the full name of the file. 

including any applicable path name Wild cards cannot he used in the file designa- 

r:o: 

"i. 



F.S BX should point to a parameter block that provides necessary information 
f OI loading the file. The parameter block is organized as follow's: 

loao_parms DW SEG ENV_STRING {Environment string segment 
DW OFFSET C‘4D_LINE {Offset of default command 

OW SEG CMO_LINF. {Segment of default command 

DW OFFSET FCB_1 {Offset Of default FOB 1 

DW SEG FC8_i {Segment of default FC6 1 

DW OFFSET FCB_2 :Offset of default FCB 2 

DW SEG FC0_2 {Segment of default FCB 2 

DW OF e SET CODE_ADR {Offset of starting code address 

OW SEG CODE_AOR {Segment of starting code address 
DW OFFSET ST_ADR {Offset of stack address 

Dw S'£T ST_ADR ;Segment of stack address 

The loaded file ov program is called a child of the original program, which is 
referred to as the parent. All open files (except files with their inheritance bit set) are 
available for the child program. Because this service destroys all registers, remember 
to save all registers before using this service and restore them after returning. 

On return, the cam' flag indicates whether an error has occurred. If the carry 
flag is set. A\ contains the error code, which can be handled through service 21/59- 
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Load Overlay (Interrupt 21h, service 4Bh, function 03h) 

Category: System services 

Registers on Entry: 

AH: 4Bh 

AL: 03h 

BX: Offset address of parameter block 

DX: Offset address of path name 

DS: Segment address of path name 

ES: Segment address of parameter block 

Registers on Return: • 


AX: Error code 

Memory Affected: If located, the desired file is loaded into memory, overwriting 
the current program area. 


Syntax: 


MOV 

AX.CS 

Code segment is same as 

MOV 

DS.AX 

data segment and 

MOV 

es.ax 

extra segment 

MOV 

DX,OFFSET FILE_PATH 

Offset address of path 

MOV 

BX, OFFSET OV^RLAY_PARM$ 

Offset address of parameters 

MOV 

MOV 

AL,03h ■ . . j 

AH,4Bh 

Load an overlay 

1NT 

2lh ; 

;DOS services interrupt 


Description: This service enables a disk file to be loaded as an overlay (placed over 
the current program in memory), starting at the memory address indicated in the 
parameter block. 

\ 

DS:DX should point to an ASCIIZ (null-terminated ASCII) string that contains 
the full name of the file, including any applicable path name. Wild cards cannot be 
used in the file designation. 

ES:BX should point to a parameter block that provides necessary information 
for loading the file. The rwo possible parameter blocks are organized as follows: 

OVERUAY_PARMS DW SEG LOAD_POINT ;Segment of loading point 

^ oo00 ” {Relocation factor for file 

Because this service destroys all registeis. remember to save all registers before 
using this service and restore them after returning On return, the carry flag indicates 
whether an error has occurred. If the carry flag is set. AX contains the error code, 
which can be handled through service 21/59 
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Part IV: Reference 



Set Execution State (Interrupt 21h, 


service 4Bh. function 05h) 


Category': System services 

Registers on Entry: 

AH: -»Bh 

Al.: 05h 

DX; Offset address of parameter block 

DS: Segment address of parameter block 

Registers on R ‘turn: Unchanged 

Memory Affected: None 

Syntax: 


MOV AX,CS 

MOV DS,AX 

MOV DX,OFFSET EXEC_STATE 
MOV Al,C5h 

MOV AH, 48h 

INT 21H 


;Code segment is same as 
; data segment 
;0ffset address of parameters 
;Load and execute 

;D0S services interrupt 


Description: This service prepares DOS to transfer control to a new program, either 
a child or nn overlay Included in this preparation is setting the DOS version number 
used by the new program (as in the DOS 5 SETVER command). 

DS DX should point to a parameter block that provides necessary information 
for the preparation. The parameter block is organized as follows: 


EXEC.STATE 


DW 

0 

•.Reserved; must be C 

DW 

TYPE_FLAGS 

;Type flags for new program 

DW 

OFFSET PR0G_NAME 

;0ffset of ASCIIZ for program name 

DW 

SEG PR0G_NAME 

;Segment of ASCIIZ for program name 

DW 

SEG NEW_PSP 

;Segment of new PSP for program 

DD 

PROG_START 

;CS:1P address of new program 

DW 

PR0G_SIZE 

;Size of program and PSP in bytes 


This function should be called immediately before control is transferred to 
the child or overlay program. The Type_flags parameter in the parameter block 
specifics the type of program to which execution will be transferred ( 1 *EXE 
program. 2=overlay program). 
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Process Terminate (Interrupt 21h, service 4Ch) 

Category- System service? 

Registers on Entry: 

Ah: 4Ch 

AL: Return code 

Registers on Return: Undefined (does not return) 

Memory Affected: Although not altered, the memory area used by the progra 
made available to future programs. 

Syntax: 


MOV 

MOV 

1NT 


AL,RETIJRN_C0DE 
AK,4Ch 
?1h 


;P.eturn code to pars 


•DOS services interrupt 
int /m * 

D «crip«ion : This or 

«"***• ta,chf,,c commintf - 



Get Return Code of a Subprocess 
(Interrupt 21h, service 4Dh) 

Category: System services 


Registers on Entry: 


AH: *Dh 

Registers on Return: 

AX: Return code 

Memory Affected: None 


Syntax: 

MOV AH,4Dh .qqs services interrupt 

INT 21 h 
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Description: This service retrieves the return code that a child program passes 
through service 21/4C. A reliable return code can be retrieved only once. 

The returned value, in AX, is divided into two pans. A L contains the value 
passed by the child program, and AH contains one of the values shown in table 21.20. 

Table 21.20. AH return codes for service 21/4D. 

Value Meaning 

0 Normal 

1 Ctrl-Break 

2 Critical error 

3 Terminate and stay resident (TSR) 


Search for First File-Name Match 
(Interrupt 21h, service 4Eh) 

Category: Disk services 

Registers on Entry: 

AH: 4Eh 

CX: File attribute 

DX: Offset address of file name 

DS: Segment address of file name 

Registers on Return: 

AX: Error code 

Memory Affected: If the service locates a file-name match D( * liUs th* mrmr.™ 
area apedfied aa the DTA with « bytes of file informal 

Syntax: 


PUSH CS 
POP os 

MOV OX,OFFSET PATH NAME 

MOV AH,4Eh 
INT 21h 

JC ERROR 


;Code segment and 
i data segment are same 
;Offset address of path 

•DOS services interrupt 
;Branch if error 
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n 111 i iiitnn This service locates a file with a specified file name. DS.DX shotfid 
^oanASCUZ (null-terminated ASCII, E 

file, including any applicable path name. Wild cards 

"“‘Tr place the desired file-attribute value in CX. Actually .be^the file 

attribute is only one byte long, you should this table, a / in a 

to 0. Table 21.21 shows bit meanings of the ®** n *“*“ jEeted. a g me ans that the 
bit position indicated by an a means that the acmbute « selecte . 

attribute is not selected. _ 


Table 21.21^3: i settings f or file attrib ute^ - e> ince 21/4 ^_ 


Bits 

76543210 


Meaning ____ 

Reserved—-set tc 0 

Archive— does not apply to this service 

Subdirectory 

Volume label 

System 

Hidden 

Read-only— does not apply to this service 


. e *-a-chine for files with matching attributes. 

DOS follows a peculiar “ ^ih no special attributes). Selecting 

IfCXii set to 0. DOS locates subdlrea0 ry. system, or hidden bits set 

^“Ss anTn^nal files being seleoed. If the volume-label b.t« set. 
with a volume-label attribute match, 

only feres witn a vo. has occurred. If the cany 

Or. rerum, the car? fl J*‘ n ^^, hieh ^ be handled through service 21/59. 
Oag is set. AX contains the c m in DTA with 43 bytes of information 

* —--—■ 

—. _ _ _ l If fid hu DOS 


FIIE.ATTR 

FIL£_T1»*E 

FILE.DATE 

file.size 

FILE.NAHE 


21 DUP(®) 
00 

0000 

eooe 

ococoooe 
13 DUP(0) 


;Reserved- -used by DOS 
;File attribute 
•.File time 
;File date 
;File size 

;ASCIIZ of tile name 


F,Lt - HW ‘ E “ ’ 3 uinHLE make is tefi-ioadfird, with a period between the 

The file name returned m f ILfJw* 

root and extension. 
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Port IN': Rclcrcncc 


Search for Next FiJe-Name Match 
(Interrupt 21h, service 4Fh) 

Category: Disk services 


Registers on Entry: 

AH: 4Fh 

Registers on Rctunc 
AX: Error code 

Memory Affected: If the service locates a file-name match. DOS fills in the memory 
area specified as the DTA with 43 bytes of file information. 

Syntax: 

MOV AN,4Fh 

INT 21 ;DOS services interrupt 
JC ERROR ;Branch if error 


Description This service locates the next file with a specified file name. Before vou 
imoke this service, the DTA must be set by a call to service 2I/4E Otherwise the 
msuhs can he unpredictable. Fol more information, see the desenptfonTse^ce 


Because any given directory must contain uniaue fil^ Mm H 
useless if the file specification for which you l 2 ’ ' “ 

question-mark (?) wild card. h ng does not c °ntam the 



Set PSP Address (Interrupt 21h, service 50h) 

Category: System services 
Registers on Entry: 


AH: 50h 

CX: Segment address of new PSP 

Registers on RetuAi: None 
Memory Affected: None 


Syntax: 


MOv BX,SCO NEWPSP 

MOV AH,son 
INT 2lh 

;0os services interrupt 
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Description; l his service allows you 10 define the address of ? new uregram 
segment prefix (PSP) for ’.he currently executing program. If you do not specify a 
valid segment address tor a PSF in the BX register, the results of using this ser-'ice are 
unpredictable 


Get PSP Address (Interrupt 21h, service t>lh) 

Category: System services 
Registers on Entry: 


Registers on Return: 

BX; Segment address of current PSP 

Memory Affected: None 

Syntax: 


MOV /.H # £1h 

INT 21h ;DOS services interrupt 

MOV PSP_SEG,3X ;Store the segment address 

Description: This service allows you to determine the segment address of the 
program segment prefix (PSF) for the currently Executing program. 


Get Verify Setting (Interrupt 21h, service 54h) 

Category: System services 
Registers on Entry: 

AH: 54h 

Registers on Return: 

AL: Verily flag 

Memory Affected: None 
Syntax: 

“OV AH,54h 

IN T 21 h ;DOS services interrupt 
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description This service returns the system flag that specifies wherher DOS 
verifies, after each disk v/rite, that »:he information has beer, recorded accurately, rhe 
return value in A! signifies the state of the verify flag if AJ.-O, »>:t verify flag is off. 
If AL*= X, the verify flag is on. 

If you are working with a network system, verification i> />0i supported; 
tberefote, the return value has r?o meaning. 


Rename File (Interrupt 21h, service 56h) 

Category: Disk services 


Registers on Entry: 


AH: 56h 

DX: Offset address oi old file name 

01: Offset address of new file name 

DS: Segment address of old file name 

ES- Segment add^ss of new file rain? 

Registers on Return*. 

AX: Error code 

Memory Affected: None 


Syntax: 

MOV 

AX.CS 

MOV 

PS, AX 

MOV 

ES,AX 

MOV 

OX,OFFSET OLD_FILE 

MOV 

01,OFFSET NEWFII.E 

MOV 

AH,56H 

INT 

21h 


jCode segment is same as 
; data segment and 
; extra segment 
;Offset address of old file 
;Offset address of new file 

;DOS services interrupt 


Description: This service allows you to rename files, using ASCIIZ strings. DS:DX 
should point to an ASCIIZ (null-terminated ASCII) suing that contains the full name 
of the old file, including any applicable path name. ES:D1 should point to a similar 
string for the new file. 


Because the directory paths for the files may differ, you can rename files across 
directories. The only restriction is that both files must reside on the same drive. 


On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59- 
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Get/Set File Date and Time (Interrupt 21h, service 57h) 

Category: Disk services 


Registers on Entry: 


AH: 

57h 

AL: 

Function code 

BX: 

File handle 

CX: 

New file time 

DX: 

New file date 

Registers on Return: 

AX: 

Error code 

CX: 

File time 

DX: 

File date 


Memory Affected: None 
Syntax: 

MOV AL,0 ;Get file date and tine 

MOV BX,F1LE_HANDLE ;Use this handle 

MOV AH,57h 

INT 21h ;D03 services interrupt 

i 

Description: This service allows you to retrieve or set the date and time for an open 
file, based on the function code inAL lfAL«=0, the service retrieves the file date and 
time; if AL= 1, the service sets the file date and time. 

If you are setting the file date and time, specify the time in CX and the date 

in DX. 

On return, the carry flag indicates whether an error has occurred. If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59. 
If the carry flag is dear and AL* 0, CX and DX reflect, on return, the file time and date, 
respectively. 


Get Allocation Strategy (Interrupt 21h, 
service 58h, function OOh) 

Category: System services 

Registers on Entry: 

AH: 58h 

AL: OOh 
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Register! on Return: 

AX: Strategy code 

Memory Affected: None 
Syntax: 

Mov al,0 ;Get strategy code 

MOV AH.SBh 

INT 2lh ;DOS services interrupt 

MOV STRATEGY,AX ;Store for later use 

Description: This function is used to determine which of several memory-allocation 
strategies DOS is using. The value returned in AX can be one of those shown in 
table 21.22. 

Table 21.22. AX return codes for service 21/58/00. 

Value Stra tegy Meaning _ 

00h Search conventional memory for the first available memory 

block (default strategy) 

Olh Search conventional memory for the first contiguous block 

that is large enough 

02h Search conventional memory for the last available block 

40h Search high memory for the first available memory block 

41h Search high memory for the first contiguous block that is 

large enough 

42h Search high memory for the last available block 

80h Search high memory for the first available memory block, 

then look in conventional memory 

gXh Search high memory for the first contiguous block that is 

large enough, then look in conventional memory 

g2h Search high memory for the last available block, then look 

in conventional memory 
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Set Allocation Strategy (Interrupt 21h, 
service 58h, function Olh) 


Category: System services 

Registers on Entry: 

AH: 58h 

AL: Olh 

BX: Strategy code 

Registers on Return: 

AX: Error code 

Memory Affected: None 

Syntax: 

MOV STRATEGY,BX ;Store for later use 

MOV AL,1 ;Set strategy code 

MOV AH,5Bh 

INT 21h ;00S services interrupt 

JC STRAT_ERR ;Error occurred 

Description: This function is used to set the memory-allocation strategy DOS 
should use. The strategy specified can be any of those shown in table 21.22 (see 
service 21/58/00). 

On return, the carry flag indicates whether an error has occurred If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59. 


• - ‘at - Kaf a #« i 


Get High-Memory Link Status (Interrupt 21h, 
service 58h, function 02h) 

Category: System services 

Registers on Entry: 

AH: 58h 

AL: 02h 

Registers on Return: 

AL: Link code 

Memory Affected: None 
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;Get link status cods 


Syntax: 

MOV AL,2 
MOV AH,58h 

INT 21 h ;DOS services interrupt 

Description: In DOS 5, DOS can be directed to use the high-memory area. This 
function tests whether that area is available for use. On return, if the carry flag U 
clear, AL will contain the link code. lfAL=l, the high-memory area is available; If 
AL*0, that area is not available. 

If the carry flag is set on return, an error has occurred. If the carry flag is set, 
AX contains the error code, which can be handled through service 21/59* 




Set High-Memory Link Status (Interrupt 21h, 
service 58h, function 03h) 

Category: System services 

Registers on Entry: 

AH: 58h 

AL: 03h 

BL: Link code 

Registers on Return: 

AX: Error code 

Memory Affected: None 

Syntax: 

MOV BL,0 ;Unlink high memory 

MOV al, 3 ;Set link status code 

MOV _ AH ,58h 

INT 21 h ;DOS services Interrupt 

Description: In DOS 5, DOS can be directed to use the high-memory area. This 
function sets whether that area can be used. If BL is set to 1, the high-memory area 
is linked; if BL is set to 0, it is unlinked. 

On return, the carry flag indicates whether an error has occurred.' If the carry 
flag is set, AX contains the error code, which can be handled through service 21/59* 


Scanned by CamScanner 


Get Extended-Error Information 
(Interrupt 21h, service 59h) 

Category: System services 

Registers on Entry: 

AH: 59h 

BX: 0 

Registers on Return: 

AX: Extended-error code 

BH: Error class 

BL: Suggested remedy 

CH: Locus 

Memory Affected: None 

Syntax: 


PUSH 

AX 

{Store all registers 

PUSH 

BX 


PUSH 

CX 


PUSH 

DX 


PUSH 

OX 


PUSH 

SI 


PUSH 

ES 


PUSH 

DS 


MOV 

Bx.e 


MOV 

AH.SOh 


INT 

21h 

;D0S services Interrupt 

MOV 

ERROfi_CODE,AX 

;Store returned values 

MOV 

ERROR_CLASS,BH 


MOV 

ACTION,BL 


MOV 

LOCUS,CH 


POP 

DS 

{Restore all registers 

POP 

ES 


POP 

SI 


POP 

01 


POP 

DX 


POP 

CX 


POP 

BX 


POP 

AX 



Description-. This service, not available before DOS version 3 0. returns detailed 
information on system errors that have occurred The service is used for DOS service 
calls that use the carry flag to signify an error. 


Scanned by CamScanner 


The error code is the general astern error code. The classes provide further 
information about the error classification. The suggested actions provide remedies 
that DOS "thinks" are appropriate fer the type of error and the circumstances of its 
occurrence. The locus is the genera! hardware area where the error occurred. 

Because this service destroys virtually aU registers, you should save all the 
registers if you need their contents. 

The error code returned in AX is one of the values shown in table 21.23. The 
possible error classes returned in BH are shown in table 21.24; possible suggested 
actions returned in BL are shown in table 21.25; and table 21.26 details the locus 
returned in CH. 


Table 21.23. 

Possible extended-em^r codes returned in AX for service 21/59 • 

Value 

Meaning 

1 

Invalid function 

2 

File not found 

3 

Path not found 

4 

Too many file handles open 

5 

Access denied 

6 

Invalid handle 

7 

Memory control blocks destroyed 

8 

Insufficient memory 

9 

Invalid memory-block address 

10 

Invalid environment 

11 

Invalid format 

12 

Invalid access code 

13 

Invalid data 

14 

Reserved 

15 

Invalid drive 

16 

Attempt to remove current directory 

17 

Not same device 

18 

No more files 

19 

Disk write-protected 

20 

Unknown unit 

21 

Drive not ready 

22 

Unknown command 

23 

CRC error 
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Value Meaning 


24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 


Bad request structure length 
Seek error 

Unknown media type 
Sector not found 
Out of paper 
Write fault 
Read fault 
General failure 
Sharing violation 
Lock violation 
Invalid disk 
FCB unavailable 
Sharing buffer overflow 
Code page mismatched 
End of file (using handles) 

Disk full (using handles) 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reseived 

Network request not supported 
Remote computer not listening 
Duplicate name on network 
Network name not found 
Network busy 

Network device no longer exists 
NetBIOS command limit exceeded 
Network adapter error 


t nnttnun 
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Table 21.23 . continued 


Value Meaning 


58 

Incorrect network response 

59 

Unexpected network error 

60 

Incompatible remote adapter 

61 

Prim queue full 

62 

Not enough space for print file 

63 

Print file deleted 

64 

Network name deleted 

65 

Network access denied 

66 

Network device type incorrect 

67 

Network name not found 

68 

Network name limit exceeded 

69 

NetBIOS session limit exceeded 

70 

Temporarily paused 

71 

Network request not accepted 

72 

* Print or disk redirection is paused 

73 

Reserved 

74 

Reserved 

75 

Reserved 

76 

Reserved 

77 

Reserved 

78 

Reserved 

79 

Reserved 

80 

File exists 

81 

Duplicate FCB 

82 

Cannot make directory entry 

83 

Fall on INT 24 

. 84 

Too many redirections 

85 

Duplicate redirection 

86 

Invalid password 

87 

Invalid parameter 

88 

Network data fault 

89 

Function not supported by network 

90 

Required system component not installed 
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Table 21.24. Possible error classes returned in BHfor service 21/59. 


Value Meaning 


Out of resource 
Temporary situation 
• Authorization 

l Internal system error 

> Hardware failure 

S System failure 

7 Application program error 

B File or item not found 

9 Bad file or item format 

0 Locked file or item 

1 Media problem 

2 File or item already exists 

3 Unknown 


Table 21.25. Possible suggested actions returned in BLfor service 21/59. 


Value Meaning _._ 


1 Retry immediately 

2 Delay then retry 

3 Reconsider user Input 

4 Abort with cleanup 

5 Immediate exit without cleanup 

6 Ignore the error 

7 Retry after action taken 



Table 21.26. Possible locus values returned in CH for service 21/59. 


Value 


Meaning 


Unknown 
Block device 
Network 
Serial device 
Memory 
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Create Temporary File (Interrupt 21h, service 5Ah) 


Category: Disk services 

Registers on Entry: 

AH: 5 Ah 

CX: File attribute 

DX: Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Return code •' 

DX: Offset address of completed path name 

DS: Segment address of completed path name 

Memory Affected: The 6!e name of the unique file created is apper J cd to the 

ASC11Z string specified bv PS:DX. 


Syntax: 


PUSH 

cs 

■ ;Code segment and 

POP 

OS 

; data segment are same 

MOV 

OX,OFFSET PATHNAME 

;0ffset address of path 

MOV 

CX.O 

;Normal file 

MOV 

AH,5Ah 


INT. 

21h 

;D0S services interrupt 

JC 

ERROR 

;Branch if error 

MOV 

FILE_HANDLE,AX 

;Store returned handle 


Description: This service, not available before DOS version 3.0, causes a file with 
a unique file name to be created in the specified directory. DS:DX should point to 
an ASCIIZ (null-terminated ASCI!) string which contains the path name of the 
directory that will contain the file. This path name should end with a backslash. 

You should place the file attribute in CX. Actually, because the file attribute is 
only one byte Jong, place the new setting in CL, and set CH to 0. Table 21.27 shows 
the possible file-attribute settings. In this table, a i in a bit position indicated by an 
x means that the attribute is selected; a 0 means that the attribute is not selected. 
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Table 21.2 7. Hit settings for file attribute, service 21/43 


Bits 

7654321© Meaning 


00 

Rcsen'ed—set to 0 

V 

4\ 

Archive 

© 

Subdirectory—set to 0 for this sen ice 

Q 

Volume label—set to 0 for this sen ice 

X 

System 

X 

Hidden 

X 

Read-only 


This service is helpful for programs that need temporary files for program 
purposes. The sen ice generates a unique file name and opens the file fo. read'write 
operations. The file stays open until you close it and is not deleted unless vou de¬ 
lete it. 


On return, the carry flag indicates whether an error has occurred. If the* carry 
flag is set. AX contains the error code, which can be handled through scn .ce 21/59- 
If the earn- flag is clear. AX contains the file handle for the newly created file, and 
DS:DX points to an ASCIIZ string that represents the full path name of the created 

file. 



Create File (Interrupt 21h, service 5Bh) 

Category: Disk services 

Registers on Entry: 

AH: ‘ 5Bh 

CX: Tile attribute 

DX. Offset address of path name 

DS: Segment address of path name 

Registers on Return: 

AX: Return code 

Memory Affected: None 
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Syntax: 

PUSH CS 

POP OS 

MOV OX,OFFSET PATH_NAME 

MOV CX,0 

MOV AH.SBh 

INT 21h 

JC ERROR 

MOV FllE_HANOLE,AX 


;Code segment and 
; data segment are same 
;Offset address of path 
;File attribute is normal 

;DOS services interrupt 
;Carry set, handle error 
;Store returned handle 


Description: This service, not available before DOS version 3.0, creates a disk file. 
On entry, DS:DX points to an ASCIIZ (null-terminated ASCII) string that contains the 
full name of the file, including any applicable path name. You set CX to equal the 
desired attribute for the file. 


This service is identical to service 21/3C except that if the file name specified 
in the ASCIIZ string already exists, an error code is returned. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. If the carry flag 
is not set, the operation was successful, and AX contains the file handle for the newly 

opened file. This number (file handle) can be used in many other DOS file 
operations. 


When this service is completed, the specified file is left open. You do not need 
to open the file, but you must remember to close it. 



File Access Control (Interrupt 21h, service 5Ch) 

Category: Disk services 

Registers on Entry: 

AH: 5Ch 

AL: Function code 

BX: File handle 

CX: Region offset high 

DX: Region offset low 

Dh Region length low 

SI: Region length high 

Registers on Return: 

AX: Error code 
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Memory Affected: None 
Syntax: 

MOV Al, 0 ;lock region 

MOV BX,FILE_HANDLE ;Use this file 

MOV CX,PTR_HIGH -.Offset into file 

MOV OX,PTR_LOW 

MOV Sl.C ;Only lock 1 record 

MOV DI,REC_LEN 

MOV AH,5Ch 

INT 2th ;DOS services interrupt 

JC ERROR ;Branch if error 

Description: This service, not available before DOS version 3 0, provides a simole 
access-limitation convention for files. The user can lock or unlock regions of a file, 
thereby limiting or expanding access to the file contents. This service is most usef-il 
in networked or multitasking environments. 

AL should contain either a 0 or a 1. AL=0 means to lock the file specified in 
BX; AL= 1 means to unlock the file. CX:DX contains a byte offset into the file that 
specifies the start of the region to be locked. SI:DI contains the length of the region 
to be locked. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 

Before exiting a program, be sure to remember to unlock any regions that have 
been locked. Failure to do so can have unpredictable results. 



Set Extended-Error Values (Interrupt 21h, 
service 5Dh, function OAh) 

Category: System services 

Registers on Entry: - 

AH: 5Dh 

AL: OAh 

DS: Segment address of parameter table 

SI: Offset address of parameter table 

Registers on Return: None 

Memory Affected: None 
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Syntax: 


MOV 

AX.SEG ERR_TABlE 

;Segment of error taDle 

MOV 

OS, AX 


MOV 

SI.OFFSET ERR_TABlE 

;0ffset of error table 

MOV 

AL.OAh 


MOV 

AH,5Dh 


I NT 

21h 

jDOS services interrupt 


Description: This service, not available before DOS version 3.0, provides a simple 
access-limitation convention for files. The user can lock or unlock regions of a file, 
thereby limiting or expanding access to the file contents. This service is most useful 


in networked or multitasking 

t 

environments. 

ERR_TABLE 

DV. ERR_COOE 

;Error code (AX value) 


DB CLAS$_C0DE 

;Error class code (BH value) 


OB ACT_COOE 

'.Action code (BL value) 


DW L0C_C00E 

;Location code (CX value) 


DVV val_dx 

;Value of DX register 

. 

DW VAL_SI 

;Value of SI register 


DVV VAL_DI 

;Value of DI register 


DVV VALUES 

;value of ES register 


DvV 0 

;Reserved 


DW C0MP_ID 

;Conputer system ID <0=local) 


•DW PR0C_ID 

;Process ID (0=local) 


Description: This service is used to set the extended-error information that will be 
returned the next time service 21/59 is used (assuming that sendee 21/59 is called 
before another system error occurs). 

Get Machine Name (Interrupt 21h, 
service 5Eh, function OOh) 

Category: Network services 

Registers on Entry: 

AH; 5 Eh 

AL. 0 

DX; Offset address of buffer 

DS: Segment address of buffer 
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Registers on Return: 

AX: Error code 

CH: Indicator flag 

CL: NetBIOS number 

DX: Offset address of buffer 

DS: Segment address of buffer 

Memory Affected: The memory area specified by DS:DX is overwritten with the 
returned string. 


Syntax: 

• 

uov 

AL,t 

;Get machine name 

PUSH 

cs 

;Code segment and 

POP 

DS 

; data segment are same 

UOV 

OX,OFFSET BUFFER 

;0ffset address of buffer 

uov 

AH,5Eh 


int 

21h 

;D0S services interrupt 

JC 

ERROR 

;Branch if error 


Description: You use this function, not available before DOS version 3.1, when you 
are working under local area network (LAN) software. This function returns a 15- 
byte string indicating the name of the computer on which the software is operating. 
The string is padded with spaces and is null-terminated, rendering 16 bytes in total. 

On return, if the cam- flag is set. an error has occurred and the error code is 
in AX. Sen ice 21/59 can be used to get detailed error information. 

If the carry is clear, CH contains a flag to indicate whether the name is actually 
returned. If CH is 0. no name has been defined for this computer. If CH < > 0, DS:DX 
defines and points to the name. CL then contains the NetBIOS number for the name 
atDSDX. 



Set Printer Setup (Interrupt 21h, 
service 5Eh, function 02h) 

Category: Network services 

Registers on Entry: 

AH: 5Eh 

AL: 02h 

BX: Redirection list index 

CX; Setup string length 

SL Offset address of buffer 

OS: Segment address of buffer 
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Pvgistcrs on Return: 

A\. Error code 
Memory Affected: None 
Syntax: 

MOV Al,2 ;Set printer setup 

PUSH CS >;Code segment and 

POP OS ; data segment are same 

MOV SI.OFFSET SETUP_STR ;0ff$et of setup string 

MOV CX,SETUP_LENGTH ;Length of setup string 

MOV BX,INDEX ;Redirection list 

MOV AH,5Eh 

INT 2lh ;D0S services interrupt 

JC ERROR ;Branch if error 

Description: You use this service, not agitable before DOS version 3.1. when you 
are operating under local area network (LAN) software. This service allows you to 
specify a string to precede all files sent from the local node to a network printer. The 
purpose of the string is to allow uie printer to be set up according to individual node 
requirements. DS:SI points to the string, which can be up to 64 bytes long (length 
specified in CX). BX contains the redirection-list index pointer, which is determined 
through service 21/5F/2. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 


Get Printer Setup (Interrupt 21h, 
service 5Eh, function 03h) 

Category: Network services 

Registers on Entry: 

AH: 5Eh 

AL: 03h 

BX: Redirection list index 

DI: Offset address of buffer 

ES: Segment address of buffer 

Registers on Return: 


AX: 

CX: 

Dl: 

ES: 


Error code 
Setup string length 
Offset address of buffer 
Segment address of buffer 
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Memory Affected: The memory area specified bv ES:DI is overwritten with the 
requested network information. 


Syntax: 


MOV 

AL,3 

;Get printer setup 

PUSH 

CS 

;Code segment and 

POP 

ES 

; extra segment are same 

MOV 

01,OFFSET SETUP_STR 

;0ffset of setup string 

MOV 

BX,INDEX 

;Redirect ion list 

MOV 

AH.5EM 


I NT 

21h 

;D0S services interrupt 

JC 

ERROR 

;Branch if error 


Description: You use this service, not available before DOS version 31. when you 
are operating under local area network (LAN) software. This service returns the 
printer setup string specified with service 21/5E/2 The returned value, which is 
stored at the buffer specified by ES.D1. may be up to 64 bytes long. Be sure that you 
set aside a large enough buffer area. BX contains the redirection-list index pointer, 
which is determined through service 21/5F/2. 

On return, if the carry flag is set. an error has occurred and the error code is 
in AX Service 21/59 can be used to get detailed error information. If the carry flag 
is not set, the buffer area to which ES:DI points contains the printer setup string, 
• with CX set to the string length. 


Get Redirection List Entry (Interrupt 21h, 
service 5Fh, function 02h) 

Category: Network services 

Registers on Entry: 

AH: 5Fh 

AL: 02h 

BX: Redirection list index 

DI: Offset address of network name buffer 

SI: Offset address of local name buffer 

DS: Segment address of local name buffer 

ES: Segment address of network name buffer 

Registers on Return: 


AX: 

BH. 

BL: 

CX: 


Error code 
Device status 
Device type 
Parameter value 
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SI: oftact aiUlrcM of local name buftcr 

I>S. Scguu'iu iulilrcss i>l local name bullet 
K$; Segment address of network name buffer 


Memory Affected: The buffers to which DS:SI and ES'Dl point 
the requested network Information. 


are overwritten with 


Syntax: 


MOV 

AX.CS 


Code segment is same as 

MOV 

DS, AX 


data segment and 

MOV 

ES, AX 


extra segment 

MOV 

SI,OFFSET 

LOCAL_BUF 

Offset address of buffer 

MOV 

DI.OFFSET 

NET_BUF 

Offset address of buffer 

MOV 

BX, 1 


Start with this entry 

MOV 

AL,2 


Get list entry 

MOV 

AH,5Fh 



INT 

21h 

1 

;DOS services interrupt 

JC 

ERROR 

1 

;Branch if error 


Description: You use this service, not available before DOS version 31, when you 
are operating under local area network (LAN) software. This service returns an entry 
from the redirection list, which is set up by service 21/5F/3. The buffers to which 
DS:S1 and ES:D1 point should each be 128 bytes long. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. If the carry flag 
is not set. DS:SI and ES:DI point to ASC11Z strings of the requested information; BH, 
BL, and CX all contain additional device information. This function destroys DX 
and BP. 




Redirect Device (Interrupt 21h, service 5Fh, function 03h) 

Category: Nerwork services 

Registers on Entry': 

AH: 5Fh 

AL: 03h 

BL: Device type 

CX: Caller value 

DI: Offset address of network path 

SI: Offset address of device name 

DS: Segment address of device name 

ES: Segment address of nerwork path 
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Registers on Return: 
AX: Error code 


Memor)' Affected: None 
Syntax: 


MOV AX,CS 

MOV DS.AX 

MOV ES,AX 

MOV SI.OFFSET DEVICE 

MOV 01.OFFSET NET_PATH 

MOV AL,3 

MOV AH,5Fh 

INT 21h 

JC ERROR 


;Code segment is same as 
; data segment and 
; extra segment 
;Offset of device name 
;0ffset of network path 
;Redirect 

;D0S services interrupt 
;Branch if error 


Description: You use this service, not available before DOS version 5.1, when you 
are operating under local area network (LAN) software. The service allows you to 
add devices to the network redirection list. DS:SI and ES:DI both specify ASCIIZ 
strings. 

On return, if the carry flag is set, an error has occurred and the error code is 
in AX Service 21/59 can be used to get detailed error information. 


Cancel Redirection (Interrupt 21h, service 5Fh, 
function 04h) 

Category: Network services 

Registers on Entry: 

AH: 5Fh 

AL: 04h 

SI: Offset address of device name/path 

DS: Segment address of device name/path 

Hcjistcrs oa Return: 

AX; Error code 

Memory Affected: None 
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Syntax: 


PUSH CS 

PGP DS 

MOV SI,OFFSET DEV-ICE 

MOV AL,4 

MOV AH,5Fh 

INT 21h 

JC ERROR 


;Codo segment and 
; data segment are same 
;Offset of device name 
;Get list entry 

;U0S services interrupt 
;Branch if error 


Description: You use this service, not available before DOS version 3-1, when you 
are operating under local area network (LAN) software. The service allows for 
deleting devices from the network redirection list. DS:SI specifies an ASCIIZ string. 


On return, if the carry flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 


H-UCTJC * V • ".ll JUJUMagga 

Get Program Segment Prefix (PSP) Address 
(Interrupt 21h, service 62h) 

Category: System services 
Registers on Entry: 

AH: 62h 

Registers on Return: 

BX: PSP segment address 

Memory Affected: None 
Syntax: 

MOV AH,62h 

INT 21h . :DOS services interrupt 

Description: This service, not available before DOS version 3.0, returns the 
program segment prefix (PSP) address for the current program. The PSP segment 
address is returned in BX. 

This service i* not supported in DOS 5. Use service 21/51 instead. 
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Get Extended Country Information (Interrupt 21h, 
service 65h, function Olh) 

Category: System services 

Registers on Entry: 

AH: 65h 

AL: Olh 

BX: Code page 

CX: Length of information to return 

DX: Country ID 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Registers on Return: 

AX: Error code 

DI: Offset address of buffer 

ES: Segment address of buffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with the 
requested country information. 


Syntax: 


MOV 

AL, 1 

;Want country in.'o 

MOV 

BX, -1 

;use current console device 

MOV 

OX, -1 

;Use current country 

MOV 

CX,41 

;Want all the information 

PUSH 

cs 

;Code segment and 

POP 

ES 

; Extra segment are same 

MOV 

01,OFFSET BUFFER 

;0ffset address of buffer 

MOV 

AH,65h 


IHT 

21 h 

;D0S services interrupt 


Description: This service, not available before DOS version 3 3, returns infor¬ 
mation similar to that provided by service 21/38. With service 63/64, you specify the 
information to be returned in AL and the destination in ES:D1. Because the amount 
of information is specified in CX, only pan of the information can be retrieved. 

The code page is specified in BX and the country code in DX. Tables 21.28 and 
21.29 detail the valid values for these parameters. 
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Code 


Country 


Currently installed 

-1 

United States 

437 

Multilingual 

850 

Slavic 

852 

Portuguese 

860 

Canadian-French 

863 

Nordic 

865 


Table 21.29 • Country codes. 



Country 

Code 


Currently installed 

-1 


United States 

1 


Canadian-French 

2 


Latin America 

3 


Netherlands 

31 


Belgium 

32 

• 

France 

33 

e y 

Spain 

34 


Hungary 

36 

m 

Yugoslavia 

38 

40 

Italy 

39 


Switzerland 

41 


Czechoslovakia 

42 


United Kingdom 

44 


Denmark 

45 


* 

Sweden 


* 

Norway 

47 


Poland 

48 


Germany 

49 


Brazil 

55 
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Lf>unl> »• 

Code 

\UMr.din 

61 

Portugal 

351 

Finl.in J 

358 

Krael 

972 


If the cou nt r> c ode (DX) or the code page (BX) is invalid, an error is generated 


and returned in AX 

To limit the amount of information returned, place a value of at least 5 bytes 
in CX. 

Table 21 30 details the information returned at ES D! by each possible value 
for AL. Notice the similarities to information returned by service 21/38. 

Table 21.30. Information returned for service 21/65/01. 

Bytes 

Purpose 

1 

Information specifier (1) 

2 

Size 

2 

Country ID 

2 

Code page 

2 

Date format 

5 

Currency symbol 

2 

Thousands separator 

2 

Decimal separator 

2 

Date separator 

2 

Time separator 

1 

Currency format 

1 

Currency decimal digits 

1 

Time format 

4 

Case mapping-call address 

2 

Data-list separator 

10 

Null bytes 


\ 

A 
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Gt.c uppercase Table (Interrupt 21h, 
service 65h, function 02h) 


Category: System services 

Kccistcrs on Entry: 

All. 6Sh 

Al.. 02h 

BX: Code page 

CX; OSh 

DX; Country ID 

Dl: Offset address of buffer 

FS: Segment address of buffer 

Registers on Return: 

AX: Error code 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with the 
requested information. 

Svntax: 

9 


MOV 

AL,2 

;Get mapping table address 

MOV 

BX, -1 

;Use current console device 

MOV 

* 0X.-1 

;Use current country 

MOV 

CX, 5 

;Table is only 5 bytes 

PUSH 

cs 

;Code segment and 

P.OP 

^ ES 

01,OFFSET 6JFFER 

; Extra segment are same 

MOV 

;0ffset address of buffer 

MOV 

AH,65h 


I NT 

21h 

;D0S services interrupt 


Description: This service is used to determine the address of the uppercase 
mapping table used by DOS for ASCII characters with a value greater than 127. The 
code page is specified in BX and the country code in DX. Tables 21.28 and 21.29 
detail the valid values for these parameters (refer to service 21/65/01). 

If the country code (DX) or the code page (BX) is invalid, an error is generated 
and returned in AX. 

Table 21.31 details the information returned, beginning at ES:DI. 

■J 


D 
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Table 21.M. Information returned for service 21 /05 if .\L-2. 

Bytes Purpose 

\ Information specifier 1 2) 

4 3?.-bii uppercase table address 


Get Filename Uppercase Table (Interrupt 21h, 
sen’ice 65h, function 04h) 

Category': System services 

Registers on Entry: 

AH: 65h 

AL: 04 h 

BX: Code page 

CX. 05h 

DX: Country ID 

DI: Offset address of buffer 

ES: Segment address of buffer 

Registers on Return: 

AX: Error code 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with tlic 
requested information. 


Syntax: 

MOV 

AL ,4 

MOV 

BX, -1 

MOV 

DX, -1 

MOV 

CX,5 

PUSH 

CS 

POP 

ES 

MOV 

DI,OFFSET BUFFER 

MOV 

AH,65h 

1NT 

2lh 


;Want filename mapping 
;Use current console device 
;Use current country 
;Table is only 5 bytes 
;Code segment and 
; Extra segment are same 
;0ffset address of buffer 

;D0S services interrupt 
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Description* This service is used ■« determine the address of the uppercase 
maonine table used by DOS for ASCII characters with a value greater than 127. when 
those ASCII characters appear in file names. It difiers in this way from service 

21 65 02. ^ 

The code page is specified in BX and the country code in DX. Ta^jes 21 2U and 
21.29 detail the valid values for these parameters (refer to service 21 6>1)1). If either 
the country code (DX) or the code page (BX) is invalid, an error is generated and 

returned in AX. 

Table 21.32 details the information returned beginning at ES DI. 


Table 21.32. Information returned for sennee 21/65/04. 

bytes Purpose 

1 Information specifier (4) 

4 Filename uppercase table address 


Get Invalid Filename Character Table (Interrupt 21h, 
service 65h, function 05h) 

Category: System services 

Registers on Entry: 

AH. 65h 

AL: 95h 

BX: Code page 

CX: 05h 

DX: Country’ ID 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Registers on Return: 

AX: Error code 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with the 
requested information. 
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Syntax: 


MOV 

AL,5 

;Get invalid filename char table 

MOV 

BX, 1 

;Use current console device 

MOV 

DX, -1 

;Use current country 

MOV 

CX,5 

;Table is only 5 tytes 

PUSH 

CS 

;Code segment and 

POP 

ES 

; Extra segment are same 

MOV 

DI.OFFSET BUFFER 

;0ffset address of buffer 

MOV 

AH,65h 


1NT 

21h 

;D0S services interrupt 


Description: This service returns an address which points to a table in memory that 
DOS uses to determine which ASCII characters arc invalid for use in a file name. The 
code page is specified in BX and the country code in DX. Tables 21.28 and 21.29 
detail the valid values for these parameters (refer to service 21/65/01). If the country 
code (DX) or the code page (BX) is invalid, an error is generated and returned 
in AX. 

Table 21.33 details the information returned, beginning at ES:D1. 


Table 21.33 • Information returned for service 21/65/05 

Bytes Purpose 

1 Information specifier (5) 

4 Invalid file-name character table address 


Get Sort Sequence Table (Interrupt 21h, 
service 65h, function 06h) 

Category: System services 

Registers on Entry: 

AH: 65h 

AL: 06h 

BX: Code page 

CX: 05h 

DX: Country ID 

DI: Offset address of buffer 

Segment address of buffer 


713 
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Registers on Return: 

/^X : Error code 

DI: Offset address of buffer 

ES: Segment address of buffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with the 


;Want sorting order table 
;Use current console device 
;Use current country 
;Table is only 5 bytes 
;Code segment and 
; Extra segment are same 
;Offset address of buffer 

;DOS services interrupt 

Description: This service returns an address which points to a 256-byte tabic in 
memory that DOS uses to determine the order in which ASCII characters are sorted. 
The code page is specified in BX and the country code in DX Tables 21.28 and 21.29 
detail the valid values for these parameters (refer to serv ice 21/65/01). 11 the country 
code (DX) or the code page (BX) is invalid, an error is generated and returned 

in AX. 

Table 21.34 details the information returned, beginning at ES:D1. 


Table 21.34. Information returned for sen'ice 21/65/06. 

Bytes 

Purpose 

1 

Information specifier (6) 

4 

Sorting-order table address 


requested information. 

Syntax: 

MOV AL, 6 

MOV BX, • 1 

MOV DX,-1 

MOV CX, 5 

PUSH CS 

POP ES 

MOV DI,OFFSET BUFFER 
MOV AH,65h 

INT 2lh 


Get Double-Byte Character Set (Interrupt 21h, 
service 65h, function 07h) 

Category' 1 System services 
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Registers on Entry: 

AH. 65h 

AL: 07h 

BX: Code page 

CX: 05h 

DX: Country ID 

Dl: Offset address of buffer 

ES: Segment address of buffer 

Registers on Return: 

AX: Error code 

Dl: Offset address of buffer 

ES: Segment address oUJbuffer 

Memory Affected: The buffer area to which ES:DI points is overlaid with the 
requested information. 


Syntax: 


MOV AL, 7 

MOV BX,-1 

MOV DX,-1 

MOV CX,5 

PUSH CS 

POP ES 

MOV Dl,OFFSET BUFFER 


;Want double-byte character set 
;Use current console device 
;Use current country 
;Table is only 5 bytes 
;Code segment and 
; Extra segment are same 
;Offset address of buffer 


MOV AH,65h 

1NT 21 h 


;DOS services interrupt 


Description: This service returns an address that points to a table specifying valid 
ranges for lead-in bytes for a double-byte character set. The code page is specified 
in BX and the country code in DX. Tables 21.28 and 21.29 detail the valid values for 
these parameters (refer to service 21/65/01). If the country code (DX) or the code 
page (BX) is invalid, an error is generated and returned in AX. 


fable 21.35 details the information returned, beginning at ES:D1. 


Table 21.35 . Information returned for service 21/65/07. 


Bytes 


Purpose 

Information specifier (7) 

Double-byte character-set table address 
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Convert Character (Interrupt 21h, 
service 65h, function 20h) 

Category: System services 

Registers on Entry: 

AH: 6Sh 

AL: 2oh 

DL: Character to convert 

Registers oil Return: 

AX: Prror code 

DL. Converted character 

Memory’ Affected: None 

Syntax: 

MOV AL,2«h 

MOV DL,ORIG_CHAR ;Get the character to convert 

MOV AH,65h 

INT 2lh ;DOS services interrupt 

Description: This service converts a character to its uppercase equivalent, using the 
uppercase conversion table (see serv ice 21/65/0-i). 

On return, if the carry flag is set. an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 


Convert String (Interrupt 21h, service 65h, function 21h) 

Category: System services 

Registers on Entry: 

AH: 65h 

AL: 21h 

CX: String length 

DX: Offset address of string to convert 

DS: Segment address of string to convert 

Registers on Return: 

AX: Error code 
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Memory Affected: None 


Syntax: 


PUSH 

CS 

;Code segment and 

POP 

OS 

, data segment are same 

MOV 

OX.OFFSET STRING 

;Offset address of string to convert 

MOV 

CX.STRING_LEN 

;Get length of string 

MOV 

Al,2th 


MOV 

AH ,65h 


1NT 

21h 

;DOS services interrupt 


Description: This sen-ice converts an entire string of characters to its uppercase 
equivalent by using the uppercase conversion table (refer to sen-ice 21/65 0-t). 1 he 
length of the string is specified in CX. 

On return, if the earn flag is set, an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 


Convert ASCIIZ String (Interrupt 21h, 
service 65h, function 22h) 

Category: System services 

Registers on Entry: 

AH: 65h 

AL: 22h 

DX: Offset address of string to convert 

DS: Segment address of string to convert 


Registers on .Return: 


AX 

F.rror code 


Memory Affected: None 


Syntax 

• 

• 

• • 

PUSH 

CS 

;Code segment and 

®0P 

OS 

data segment are same 

MOV 

OX,OFFSET STRING 

;Offset address af string to convert 

MOV 

AL,22h 


MOV 

AH.SSh 

• 

INT 

2ih 

jDOS services interrupt 
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c rts an entire siring of characters to its uppercase 


.7 ooerc-.sc conversion table (refer to service 21/65/01). The 

- * - “ 

< ,n n'lurn. if .he carry flag to an error has occurred and .he error code » 
in AX. Service 2 1/59 can be used .o get detailed error mformanon. 


Get/Set Global Code Page (Interrupt 21h, sendee 66h) 

Category 1 System services 
Registers on Entry: 

AII: <>6h 

Al.- Function code 

BX: Code page 

Registers on Return: 

AX: i..n>rcode 

BX Code page 

DX: Boot code page 

Memory- Affected: None 

Syntax: 

MOV al ,1 ;Get global code page 

MOV ah, 66b 

INT 21 h ;DOS services interrupt 

JC ERROR ;Branch if error 

Description: This service, not available before DOS version 3.3, retrieves or changes 
the code page for the currently selected country information. If AL= 1, the code page 
is retrieved. If AL=2, the code page is set. 

. If you are retrieving the code page (AL=1), the contents of BX are pot 
significant when calling this service. BX and DX return the requested information. 

If you are setting the code page (AL=2), you specify the desired code page in 
BX. The only return value when you set the code page is the error code in AX (if the 
cany flag is set). 

On return, if the carry flag is set. an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 
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Change Handle Count (Interrupt 21h, service 67h) 

Category: System services 

Registers on Entry: 

AH: 6™h 

BX: Number of handies 

Registers on Return: 

AX: Error code 

Memory Affected: None 

Syntax: 

MOV BX,50 
MOV AH,6'/h 
1NT 

Description: This service, not available before DOS version 3-3. allows you to 
specify the number of file handles available to 1)05 ) oo specif} this number, which 
must be between 20 and 65.535, in BX. The number can be larger than 255, which 
is the maximum number of file handles definable in the CONFIG SYS file. 

On return, if the carry flag is set. an error has occurred ar.d the error code is 
in AX. Service 21/59 can be used to get detailed error information 


;Want 50 hanoles 
;00S services inter.Mot 



Flush Buffer Interrupt 21h, service 68h) 

Category: Disk services 

Registers on Entry: 

AH: 68h 

BX: File handle 

Registers on Return: 

AX: Error code 

Memory Affected: None 


719 
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Syntax: 


MO v BX,FILE_HANDLE 
MOV AH,68h 

INT 21h 

JC ERROR 


;Use this file 

;DOS services interrupt 
;Branch if error 


Description: With this service, not available before DOS version 3 0, the file buffer 
of the specified file (BX>is written Jto disk. 


r On return, if the carry flag is set. an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information. 


This was the highest-numbered service provided with any of the version 3.x 
releases of DOS. Ail servicts with higher numbers first appeared at version 4.0 or 


later. 


Extended Open/Create File (Interrupt 21h, service 6Ch) 

Category: Disk services 
Registers on Entry’: 

AH: 6Ch 

AL: OOh (required) . 

BX: Access mode (table 21.36) 

CX: File attributes (table 21.37) 

DX: Action flags (table 21.38) 

Registers on Return: 

AX: File handle 

CX: Action taken: 

00 = file existed and was opened 
01 = did not exist, was created 
02 = existed, was replaced 

Memory Affected: None 

* • 

Syntax: 


IIOV 

AX.SCMh 

MOV 

IX,§ 

MOV 

CX,f 

MOV 

0X,1 

INT 

21h 

JC 

ERROR 

MOV 

MY_HAN0LE,AX 


;read only, compatible, DOS defaults 

;open as normal file 

;fail if file does not exist 

;D0S services interrupt 

;bail out on error 

;save handle to refer to file 
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Description: This function, not av.nl.inle before DOS version -t 0. combines func¬ 
tions previously provided by sen-ices 21 *>C, 21 '3D. and 21/5B into a s, riJi i c . 
multipurpose facility that opens and creates files 

On return, il the earn - flag is set. an error has occurred and the error code is 
in AX. Service 21/59 can be used to get detailed error information 

The values available for registers upon entry to service 21/6C (the access modes 


in BX, the file attributes in CX. and the action codes in DX) are listed in tables 21 36, 
21.37, and 21.38, respectively. 

Table 21.36. Access modes for service 2J/6C fin BX) 

FEDCBA98 76543210 

Meaning 

X 

Not used 

1 

Immediate writes 

0 

Buffered writes 

1 

Return error only 

0 

I’se INT 2-ih handler 

xxxxx 

Not used 

1 

Child does not get handles 

0 

Child mhenis hjndles 

100 

Dcnv none 

011 

Deny read sharing 

*• « V 

XJ • c 

Deny write sharing 

C01 

Deny all sharing 

000 

Compatibility mode 

X 

Not used 

010 

Read. Write access 

001 

Write-only access 

000 

Read-only access 
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Table 21.38. Action flags for 

service 21/6C (in DX). 

FEDCBA98 76543210 

Meaning 

xxxxxxxx 

Not used 

Ixxx 

Not used 

01xx 

Not used 

001 X 

Not used 

0001 

Create file if it does not exist 

0000 

Fail if file does not exist 

Ixxx 

Not used 

01 XX 

Not used 

0011 

Not used 

0010 

Replace if file exists 

0001 

Open if file exists 

0000 

Fail if Tile exists 


Scanned by CamScanner 



Chapter 21: The DOS Services 


723 


Terminate Address (Interrupt 22h) 

Description: This is not a serviceable interrupt but rather a vector to the termi- 
nation handler for DOS. Control passes to this address when a program ends. 


Ctrl-Break Handler Address (Interrupt 23h) 

Description: This is not a serviceable interrupt but rather a vector to the address of 
the routine that receives control from DOS when a Ctrl-Break key combination is 
detected. 


Critical-Error Handler Address (Interrupt 24h) 

Description: This is not a serviceable interrupt but rather a vector to the address of 
the routine that receives control from DOS when a critical error is detected. 


Absolute Disk Read (Interrupt 25h) 

Category: Disk services 
Registers on Entry: 

AL: Drive number 

BX: Offset address of buffer (or parameter block if CX=-1) 

CX: Sectors to read (-1 indicates extended format for DOS 4) 

DX: Logical starting sector 

DS: Segment address of buffer (or parameter block if CX=-1) 

Registers on Return: 

AX: Return code 

Memory Affected: The buffer area specified by DS:BX (or by the parameter block 
pointed to, if extended format is used) is overlaid with information read from the 
disk. 
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Syntax: 


MOV 
MOV 
MOV 
MOV 
I NT 
POP 
JC 


AL, 2 
OX, C 
Cx 3 

BX, OFFSET DS:BUFFER 

25ft 

DX 

ERROR 


;Drive C: 

;Starting sector 0 

; Pead 3 sectors 
;Offset of buffer area 
;Reao sectors 
;Clean up stack 
;Brancft if error 


JC tnnun .. - . 

„ • Thii interrupt which allows DOS to read any sector from the d.s . ts 

^pp<:^ntlr^26h (and ,m,.ar to UIOS sersace 13*). 

To use this service. you must Inc-cifythc prcdse ph^sical tocatton j c=2 

at wbich you want to begin reading Spec t c ^ VC I numbered logically 

e, DX ,s the .ogica. staning sector al „ read Th c final 

in sequential ordtr. starting * it > d buffer (or the sectors 

registers to be set up specify which RAM area wfil tse use 
that arc read. This address is specified in DS.BX. 

With the introduction of DOS vers,on 4. an extended 
following information: 


Offset 


Length 


Contents 


OOh 
04 h 
06h 


Double word 

VC'ord 

Double wore 


Logical seaor number, zero based 
Number of sectors to transfer 
Far nointer to data buffer 


On return, if the carry flag is set. an error has occurred and the error code is 
. AX You must realize that on return from this interrupt, the flags are still on the 
stack They must be removed from the suck before the program continues. 



Absolute Disk Write (Interrupt 26h) 


Category': Disk services 


Registers on Entry: 


AL: 

BX 


Drive number 

Offset address of buffer (or parameter block 


if CX=-1) 
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CX: Sectors to write (-1 indicates extended format) 

DX: Logical starting sector 

DS. Segment address of buffer (or parameter block if CX=-1) 

Registers on Return: 

AX: Return code 


Memory Affected: None 
Syntax: 


MOV 

MOV 

MOV 

MOV 

I NT 

POP 

JC 


AL,2 
DX ,0 
CX ,3 

BX.OFFSET OS: BUFFER 

26h 

OX 

ERROR 


;Dnve C: 

;Startmg with sector 0 
;Wnte 3 sectors 
;0ffset of Duffer are? 
;Wnte sectors 
;Clear> up stack 
;Branch if error 


Description: This interrupt, which is the opposite of interrupt 25h (and similar to 
BIOS service 13/3), allows DOS te write any sector to the disk. 


To use this service, you must specify' the precise physical location on the disk 
at which you want to begin writing. You specify the drive in AL, where A—0, B— 1, 
C=2, etc. DX is the logical starting sector (All sectors on the disk are numbered 
logically in sequential order, starting with 0.) CX is the number of sectors to write. 
The final registers to be set up specify the RAM area from which to take the 
information to be written. This address is specified in DS:BX. 

With the introduction of DOS version 4. an extended format capable of deal¬ 
ing with 32-bit logical sector numbers was added to this interrupt If CX is set to -1 
rather than to a positive value, DS BX is a far pointer to a 10-byte parameter block 
with the following information: 


Offset ■ 

Length 

Contents 

OOh 

Double word 

Logical sector number, zero based 

04h 

Word 

Number of sectors to transfer 

06h 

Double word 

Far pointer to data buffer 


On return, if the carry flag is set. an error has occurred and the error code is 
in AX. You must realize that on return from this interrupt, the flags are still on the 
suck. They must be removed from the stack before the program continues 
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Terminate and Stay Resident (Interrupt 


27h) 


Category: .System services 
Registers on Entry: 

I )X. Pointer to last byte of program 
Registers on Return: Unknown (does not return) 
Memory Affected: None 
Syntax: 

MOV DX,OFFSET CS:EN?_BYTE ;Point to end of program 
INT 27h ; TSR 


Description: This interrupt, which is similar to the preferred TSR service of 21/31, 
allows the program to exit to DOS without freeing the program mem. y space. 

Because only one register is used to point to the program end point, the 
maximum usable program size for this interrupt is clearly 6-iK. Any files created or 
opened by the program remain open after this interrupt is invoked. 


a w . fwi 

Multiplex Interrupt (Interrupt 2Fh) 

Category: System services 
Registers on Entry: Varies 
Registers on Return: Vanes 
Memory Affected: Varies 

Description: This interrupt allows user-defined routines to share the space set aside 
for special DOS programs such as PRINT, ASSIGN, and SHARE. 

The use and function of this interrupt are bey ond the scope of this book. For 
more information, please refer to the DOS Technical Reference Manual. 
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Processor 
Instruction Set 


T he heart of your computer is the microprocessor. In the IBM PC or PS/2 and 
compatibles, this is usually the Intel fami'.y of microprocessors Your system may 
contain a numeric coprocessor, which Intel refers to as a Numeric Processing 
Extension, or NPX. The numeric coprocessor is used to aid in advanced mathematic 
operations. 

The instruction sets for both Intel microprocessors and NPXs are covered in 
this chapter. These include the following: 

□ 8086/8088 □ 8087 

□ 80286 □ 80287 

□ 80386 □ 80387 

Q 80486 

Notice that there is no corresponding NPX for the 80486 microprocessoi The 
80486 includes all of the capabilities of the 80387 NPX; these collective advanced 
mathematic operations are handled in the 80486 by the floating point unit, or FPL.’ 


727 
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Programming Models 

Intel describes the instruction sets of its processors in terms of 2 program¬ 
min'! model', which defines all pans of the processor that are visible to the 
programmer; those pon.ons of the device that cannot be affected directly by the 
program are omitted To use the instructions, it is helpful to know the correspond¬ 
ing programming model Let’s look at the programming model for each chip, first 
the microprocessors and then the NPXs. 


8086/8088 

The 8086 and 8088 processors are identical internally, although the 8086 has 
a full 16-bit data bus and the 8088 has an 8-bit bus automatically multiplexed to 
perform 16-bit transfers. 

T he programming model for these processors consists of the register set 

described in Chapter 1 

* 

80286 

The 80286 processor added several special-purpose registers to the 3086 
programming model. These include the following: 

Register Use 

GDT Global descriptor table 

LDT Local descriptor table 

IDT Interrupt descriptor table 

MSW Machine status word 

TASK Task register 

Typically, you will never need to use these registers. They are used only when 
programming for protected mode operation, a condition in which DOS cannot 
operate. All DOS operations run in real mode , the other operating mode of the 

S0286. 

Two of the descriptor table registers. GDT and LDT. make it possible to 
access 16M of memory address space rather than the 1M limit of the 8086/8088 
designs but this capability is available only when operating in protected mode. If 
programmed for compatibility with DOS. the 80286 is little more than a faster 
version of the 8086 8088 programming model. 
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80386 

Unlike it-s 8-bit anil 16-bit predecessors. the 80386 is a .32-bit microprocessor 
The registers in the 80386 reflect this enlarged structure The 80.386 still uses the 
same general-purpose registers as the 80868088 and the 8028t» (AX. BX. (.X. and 
DX). but the registers' full .32-bit counterpans are addressed by using the E 
(extended) prefix FAX. EBX. CCX. and I.DX arc 32-hit general-purpose registers. 
Without the E. only the lower 16 bus of each register are accessed. Using the 
traditional AL. AH. BL. BH. CL. CM. DL. or DH gives you access to 8-bit chunks of the 
lower 16 bits of the registers 

This use of the E prefix to denote 32-bit register size also applies to other 
microprocessor registers, such as BP. SI 1)1. and sp, which become I BP FSI, bill, 
and ESP. respective!). 

The other segment registers— (.>. I")S ^ v . .ind l - S ate intact as implemented 
m earlier Intel microprocessors. These registers are still 16 bits wide They are 
joined, however. b\ two additional segment ri gisters falso 16 bits wide) the I S and 
CiS registers, which operate the same as the I S icgistct 

As in earlier microprocessois. tlu 60386 uses a flags register. but it is also 52 
bus wide This flags register is examined later in this chapter 


80486 

Like the 80386. the 80486 is a 32-bit microprocessor, but contains many more 
internal functions than any previous member of the Intel microprocessor family. 

In addition to adding six' more* instructions to the set. the 80486 design moved 
the NPX functions onto the main chip. Thus, there is no 80-*87, all functions 
previously handled by an NPX were assumed by the FPU portion of the 80486 The 
chip also contains an 8K cache memory' and a built-in memory management unit 
(MMU). 

Despite these significant changes in design, the chip retains full compatibility 
with the 80386 and 8038“’ operations, and three of the six added instructions deal 
with strictly system-level programming. For all programming purposes, the 80486 
processor is just a taster version of a combined 80386 .uid 80387. 
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8087 

The first generation Intel NPX is truly that— an extension to the functionality 
of the main microprocessor The 8087 appears virtually transparent to program- 
men. The instruction and register sets of the 8086/8088 simply seem to be 
expanded. 

No special assembler directives are needed to use the 8087 mnemonic 
instructions with either MASM or TAS.M The assembler s default instruction set car. 
translate properly the 8086,8088 and 8087 source code. Vou may want to study 
Chapters 5 and 6. however, to learn about assembler options. 

In design philosophy, the 808"" is a bit different from the 80868088. It uses a 
floating stack for all operations, whereas the 8086 8088 uses general-purpose 
registers. The 8087 uses 8 internal suck registers, each of which is 80 bits wide. These 
stack registers are numbered 0 through 7, with most operations able to address the 
registers directly as ST. STH) ST(2). ST(3). and so on. through ST(. ) 

In addition to this stack-oricnied design, the 808“ r uses several other registers 
to reflea the condition of its stack and to control NPX operation The status word 
and control word are described later in this chapter. 


80287 

The function and operation of the 80287 are similar to those of the SOS - ’. This 
second-generation NPX can operate at levels demanded by the 80286, the micropro¬ 
cessor with which it should be paired. Several mnemonic instructions were added 
tc tAe advantage of the expanded capabilities of the 80286. 

The design structure of the 80287 is virtually equivalent to that of the 8087. 
The 8028 ~ changes the definition of several hit'- in the control word, but otherwise 
nothing charqes 


80387 

As you might expect, the 80387 is the numeric processor extension for the 
80386 microprocessor. The 80387 added only a few new commands not present 
in the 80287 and defined one additional bit in the status word. All other operations 
and structure remain the same as for the earlier generations of NPXs. 
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Instruction Sets 

The NPX functions, because they arc an extension of the instructions offered 
by the microprocessor. arc considered an integral part of the overall instruction set 
of the Intel family. 

The overall instruction set can be divided according to the purpose of the 
individual instruction. The nine general classifications of instructions (six for CPUs 
and three more for numeric coprocessors) are as follows: 

□ Data transfer 

□ Arithmetic 

□ Numeric transcendental 

□ Numeric constant 

ZJ Bit manipulation 

□ Numeric comparison 

Q String manipulation 

□ Control transfer 

Q Flag and processor control 

Let's take a look at the processing instructions in each area. 


Data-Transfer Instructions 

This group of instructions is used to move data. The movement can be between 
registers, between registers and memory, or between memory locations. The 
following 86 instructions are included: 


BSWAP 

FST 

INSW 

LGDT 

FBLD 

FSTP 

LAHF 

LGS 

FBSTP 

FXCH 

LAR 

UDT 

FTLb 

IN 

LDS 

LLDT 

FIST' 

INS 

LEA 

LMSW 

F1STP 

1NSB 

LES 

LSL 

FLD 

INSD 

LFS 

LSS 
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l.TR 

PUSHA 

SETNA 

SETP 

MOV 

PUtlAD 

SFTNAF. 

SETPF 

MOVSX 

PUSHF 

SETNB 

SETPO 

MOVZX 

PUSHFD 

SETNBE 

SETS 

OUT 

SAHF 

SETNC 

SETZ 

O’JTS 

SETA 

SETNE 

SGDT 

OUTsB 

SETAE 

SETNG 

SIDT 

OLTSD 

SFTB 

SHTNGE 

SLDT 

omsw 

setbe 

SETNL 

SMSW 

POP 

SI'TC 

M.TNLF 

STR 

POPA 

SETH 

SETNO 

XADO 

POPAD 

sure 

SETNP 

XCHG 

POPF 

SETGE 

SETNS 

XLAT 

POPFD 

SETL 

SETNZ 


PUSH 

SETLE 

SETO 



Not all of these instructions are available on all microprocessors or NPXs. 
Later, this chapter specifics which instructions work on which chips, ^ou can also 
refer to the detailed instructions at the end of the chapter for more information. 


Arithmetic Instructions 

This classification of instruction includes the simplest of mathematic opera¬ 
tions. These instructions are used for operations like conversions, BCD math, 
integer math, and simple floating-point math. Included in this grouping are the 
following 49 instructions: 


AAA 

CUD 

FDIV 

FMUL 

FSUBRP 

AAD 

CWDE 

FDIVP 

FMULP 

FXTRACT 

AAM 

DAA 

FDIVR 

FPREM 

1DIV 

AAS 

DAS 

FDIVRP 

FPREM1 

1MUL 

ADC 

DEC 

F1ADD 

FRNDINT 

INC 

ADD 

DIV 

FI DIV 

FSCALE 

MUL 

CBW 

FABS 

F1DIVR 

FSQRT 

NEG 

CDQ 

FADD 

F1MUL 

FSUB 

SBI> 

CMP 

FADDP 

F1SUB 

FSUBP 

SUB 

CMPXCHG 

FCHS 

FISL'BR 

FSUBR 
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Numeric Transcendental Instructions 

This group of instructions is performed only by the NPX/FPU chips It includes 
instructions that implement bas;j calculations for the following common functions. 

□ Trigonometric 

□ Inverse trigonometric 

□ Hyperbolic 

□ In-'.rse hyperbolic 

□ Logarithmic 

□ Exponential 

These tasks can be time consuming The eight instructions that make up this 
group are the following- 

F2XM1 FPATAN FSIN FYL2X 

FCOS FPTAN FSfNCOS FYL2XP1 


Numeric Constant Instructions 

This instruction group operates only on the NPX/FPU chips. It results in 
common mathematic constants being pushed on the stack (as used within the NPX/ 
FPU ). Because they are specialized and do not actually transfer data, these instruc¬ 
tions are categorized separately from the data-transfer instructions. The top stack 
register simply is set to be a constant value predefined by the instruction used. 

The seven instructions in this group are 

FLD1 FI.DLG2 FLDP1 

FLDL2E FLDLN2 FLDZ 

FLDL2T 

Bit-Manipulation Instructions 

These instructions do just what they say: the}- manipulate the bits in individual 
registers. The result of this (besides chrnged register values for some instructions) 
«that the flags register is changed to reflect the outcome of the operation. Program 
execution can then be modified based upon the outcome. The 22 instructions in 
this grouping are 
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AND 

ore 

RC1. 

su 

SHR 

arp:. 

BTR 

KCR 

SVR 

SURD 

BSF 

BTS 

ROL 

SHI 

TEST 

BSR 

NOT 

ROR 

SHIJ) 

XOR 

BT 

OR 





Numeric Comparison Instructions 

The NPX/FPU uses these instructions to set flags in the status-word register. 
As with other instructions, the results of these instructions can alter program 
execution These 10 instructions are the following: 

FCOM FCOMPP FICOMP FUCOM FUCOMPP 

FCOMP F1COM FTST FUCOMP FXAM 

String-Manipulation Instructions 

This instruction group operates on strings in memory. These strings are simply 
instructions that manipulate contiguous blocks of memory: they are not strings in 
the same sense as the term is used in high-level languages. VC'hen combined with 
repetition instructions, w hich are included in this instruction group, string-manipu¬ 
lation instructions are powerful for moving or comparing large bfo ks of informa¬ 
tion. This group contains the following 20 instructions: 


CMPSB 

LODSD 

MOVSW 

REPNZ 

SCASW 

CMPSD 

LODSW 

REP 

REPZ 

STOSB 

CMPSW 

MOVSB 

REPE 

SCASB 

STOSD 

LODSB 

MOVSD 

REPNE 

SCASD 

STOSW 


Control-Transfer Instructions 

These instructions are used to change the order in which a program is 
executed. They directly affect the program counter, loading a different memory 
address into this register. After the instruction is encountered, program execution 
conunues from a different location. 

Many of these instructions are conditional; that is, they take effect after 
matching a condition determined by the instruction. Usually the condition pertains 
to flags in the flags register or status word. These 43 instructions arc the following: 
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CAI.I. 

JCXZ 

1NT 

JE 

INTO 

JECXZ 

IRET 

JG 

JA 

JGE 

JAE 

JL 

JB 

JLE 

JBE 

JMP 

JC 

JNA 


JNAH 

JNO 

.INn 

INP 

.INBE 

INS 

JNC 

INZ 

JNE 

JO 

JNG 

.IP 

JNGK 

JS 

JNL 

JN'LE 

JZ 


l.OOF 

LOOPE 

LOOPNE 

LOOPN'ZJPE 

LOOPZ 

IPO 

RET 


Flag- and Processor-Control Instructions 


This final instruction group contains instructions that directly affect the flags 

register, status word, or control word. Included M this group are the following 46 
instructions: I ® 


BOUND 

FDISI 

FNEN1 

FSETPM 

LOCK 

CL C 

FENI 

FNINIT 

FSTCW 

NOP 

CLD 

FFREE 

FNOP 

FSTENV 

STC 

CU 

FINCSTP 

FNSAVE 

FSTSW 

STD 

CLTS 

FINIT 

FNSTCW 

FNX'AIT 

ST1 

CMC 

FLDCW 

FNSTENV 

HLT 

VERR 

ENTER 

FLDENV 

FNSTSW 

.IN'/D 

h 

fNVLPG 

VERW 

ESC 

FNCLEX 

FRSTOR 

WAIT 

FCLEX 

FNDISI 

FSAVE 

LEAVE 

WB1NVD 

fdecstp 



t : 

•W 



The Complete Instruction Set 

Now that you know which instructions fall within each group, let s take a quick 
it the entire Intel faintly instruction set along with the chips that use the 
instructtons. Table 22.1 details this information. Even more detailed information is 
available later in this chapter. 
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Table 22.1 

instructions for the Intel family 


instruction 

Meaning 

88 

AAA 

ASCII adjust for addition 

X 

AAD 

ASCII adjust for division 

X 

AAM 

ASCII adjust for multiplication 

X 

aas 

ASCII adjust for subtraction 

X 

ADC 

Add with carry 

X 

ADD 

Add 

X 

AND 

Logical AND 

X 

ARP1 

Adjust RPL field of selector 


BOUND 

Check array index against bounds 


BSh 

Bit scan forward 


BSR 

Bit scan reverse 


USVCAP 

Swap 32-bit bvtc order 


BT 

Bit test 


BTC 

Bit test and complement 


BTR 

Bit test and reset 


BTS 

Bit test and set 


CALL 

Perform subroutine 

X 

CBW 

Convert byte to word 

X 

CDQ 

Convert doubleword to quadword 


CLC 

Clear carry flag 

X 

CLD 

Clear direction flag 

X 

CLI 

Clear interrupt flag 

X 

CLTS 

Clear task switched flag 


CMC 

Complement carry flag 

X 

CMP 

Compare 

X 

CMPSB 

Compare strings by byte 

X 

CM PSD 

Compare strings by doubleword 


CMPSW 

Compare strings by v/ord 

X 

CMPXCHG Atomic compare/exchange 


CWD 

Convert word to doubleword 

X 


Chips 

286 .386 486 87 287 337 

XXX 

XXX 

XXX 

xxx 
xxx 
xxx 
xxx 
xxx 
xxx 
X X 
X X 
X 

X X 
X X 
X X 
X X 
XXX 
XXX 
X X 

xxx 
xxx 
xxx 
xxx 
xxx 
xxx 
xxx 
X X 
xxx 

X 

xxx 
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Instruction 

Meaning 

88 

286 

Chips 

386 486 87 

287 

38 

CWDE 

Convert word to extended 



X 

X 





doubleword 








DAA 

Decimal adjust for addition 

X 

X 

X 

X 




DAS 

Decimal adjust for subtraction 

X 

X 

X 

X 




DEC 

Decrement 

X 

X 

X 

X 




DIV 

Divide 

X 

X 

X 

X 




ENTER 

Make stack frame 


X 

X 

X 




ESC 

Escape 

X 

X 

X 

X 




F2XM1 

2'-l 




X 

X 

X 

X 

FABS 

Absolute value 




X 

X 

X 

X 

FADD 

Add real 




X 

X 

X 

X 

FADDP 

Add real and POP 




X 

X 

X 

X 

FBLD 

BCD load 




X 

X 

X 

X 

FBSTP 

BCD store and POP 




X 

X 

X 

X 

FCHS 

Change sign 




X 

X 

X 

X 

FCLEX 

Clear exceptions with NX'AIT 




X 

X 

X 

X 

FCOM 

Compare real 




X 

X 

X 

X 

FCOMP 

Compare real and POP 




X 

X 

X 

X 

FCOMPP 

Compare real and POP twice 




X 

X 

X 

X 

FCOS 

Cosine 




X 



X 

FDECSTP 

Decrement stack pointer 




X 

X 

X 

X 

FD1SI 

Disable interrupts with WAIT 





X 



FDIV 

Divide real 




X 

X 

X 

X 

FDIVP 

Divide real and POP 




X 

X 

X 

X 

FDIVR 

Divide real reversed 




X 

X 

X 

X 

FDrVRp 

Divide real reversed and POP 




X 

X 

X 

X 

FENI 

Enable interrupts with WAIT 





X 



ffree 

Free register 




X 

X 

X 

X 

fiadd 

Integer add 




X 

X 

X 

X 

FiCOM 

Integer compare 




X 

X 

X 

X 

ficomp 

Integer compare and POP 




X 

X 

X 

X 


continues 
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Instruction Meaning __ 

FIDIV Integer divide 

F1DIVR Integer divide reversed 

F1LD Integer load 

F1MUL Integer multiply 

FINCSTP Increment stack pointer 

PINiT Initialize processor with VC AIT 


FIST 

F1STP 

FJSUB 

FISURK 

FLD 

FLD1 

FLDCVC 

FLUENV 

FLDL2E 

FLDL2T 

FLDI.G2 

FLDLN2 

FLDPI 

FLDZ 

FMUL 

FMLLP 

FNCLEX 

FNDIS1 

FNEN1 

FNINIT 

FNC° 

FNSAVE 

FNSTCW 

FNSTENV 


Integer store 

Integer store and POP 

Integer subtract 

Integer subtract reversed 

Load real 

Load 1 0 

l.uad control word 
Load environment 
Load log,c 
Load log, 10 
Load log jf) 2 
Load log^ 2 
Load ~ 

Load 0.0 
Multiply real 
Multiply real and POP 
Clear exceptions 
Disable interrupts 
Enable interrupts 
Initialize processor 
No operation 
Save state 
Store control word 
Store environment 


88 


Chips 

286 386 486 87 287 387 

X x x X 
x x x X 

xxx x 
xxx x 
xxx x 
xxx x 

X x x x 

xxx x 
xxx x 
xxx x 

xxx X 

xxx x 

xxx X 
xxx X 
XXX X 
X XXX 
XXX X 
XXX X 
XXX X 
XXX X 
XXX X 
XX X X 

XXX x 

X 

X 

xxx x 

X X x x 

X X X x 

XXX x 
X X X x 
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Instruction Meaning 


88 


Chi; . 

286 J86 i8 



FNSTSW 

FPATAN 

FPREM 

FPREM1 

FPTAN 

FRNDINT 

FRSTOR 

FSAVE 

FSCALE 

FSETPM 

FSIN 

FS1NCOS 

FSQRT 

FST 

FSTCW 

FSTENV 

FSTP 

FSTSW 

FSUB 

FSUBP 

FSUBR 

FSUBRP 

FTST 

FUCOM 

FUCOMP 

FUCOMPP 

FWAIT 

FXAM 

FXCH 

fxtract 


Store status word 
Partial arctangent 
Partial remainder 
IEEE partial remainder 
Partial tangent 
Round to integer 
Restore state 
Save state with WAIT 
Scale 

Set protected mode 
Sine 

Sine and cosine 
Square root 
Store real 

Store control word with WAIT 
Store environment with WAIT 
Store Real and POP 
Store status word with WAIT 
Subtract real 
Subtract real and POP 
Subtract real reversed 
Subtract real reversed and POP 
Test 

Unordered compare 
Unordered compare and POP 
Unordered compare and POP twice 
CPU wait 
Examine 

Exchange registers 

Extract exponent and significand 


FYL2X Y*log^X 



contirn ..-1 
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instruction 

FVL2XP1 

HLT 

1DI\ 

1MLI. 

IN 

INC 

INS 

INSB 

I.NSU 

1NSNX 

INT 

INTO 

INVD 

1NVLPG 

IRET 

JA 

JAE 

j» 

JBE 

JC 

JCXZ 

JE 

JECX/ 

JG 

JGE 

JL 

JLE 

JMP 

JNA 

JNAE 


Meaning _^ 

Y*log,(X+l) 

Hall x 

Integer divide X 

Integer multiply X 

Input from port X 

Increment X 


Input string from port 
Input string byte from port 
Input string doubleword from port 
Input string word from port 


Software interrupt X 

Interrupt on overflow X 

Invalidate full cache 
Invalidate TLB entry 
Return from interrupt X 

Jump if above X 

Jump if above or equal X 

Jump if below X 

Jump if below or equal X 

Jump on carry X 

Jump if CX=0 X 

jump if equal X 

Jump if ECX=0 

Jump if greater X 

Jump if greater or equal X 

Jump if less X 

Jump if less or equal X 

Jump X 

Jump if not above X 

Jump if noi above or equal X 


286 386 486 87 

X X 

XXX 
XXX 
X X X 
XXX 
XXX 
X X X 
XXX 
X X 
XXX 
XXX 
XXX 
X 
X 

XXX 
XXX 
XXX 
XXX 
XXX 
XXX 
XXX 
XXX 
X X 

xxx 

xxx 

xxx 

xxx 

xxx 

xxx 

xxx 


287 387 
X X 
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Instruction 

Meaning 

JNB 

Jump if not below 

JNBE 

Jump if not below or equal 

JNC 

Jump on no carry 

JNE 

Jump if not equal 

JNG 

Jump if not greater 

JNGE 

Jump if not greater or equal 

JNL 

Jump if not less 

JNLE 

Jump if not less or equal 

JNO 

Jump on no overflow 

JNP 

Jump on no parity 

JNS 

Jump on not sign 

JNZ 

Jump on not zero 

. J° 

Jump on overflow 

JP 

Jump on parity 

JPE 

Jump on parity even 

JPO 

Jump on parity odd 

JS 

Jump on sign 

JZ 

Jump on zero 

LAHF 

Load AH with flags 

LAR 

Load access-rights byte 

LDS 

Load DS register 

LEA 

Load effective address 

LEAVE 

High-level procedure exit 

LES 

Load ES register 

LFS 

Load FS register 

LGDT 

Load GDT register 

LGS 

Load GS register 

UDT 

Load IDT register 

LLDT 

Load LDT register 

LMSW 

Load machine status word 

LOCK 

lock bus 


Chips 

88 286 386 186 H 7 28 7 W 

X X x x 

X X x x 

X x x x 

X x X X 

X x x X 

x X x X 

X X x x 
X X x X 

X x x x 

X x x x 

X x X X 

X X X X 

X X X X 

X X x X 

X x x x 

X X X X 

X x x X 

X X X X 

X X X x 

xxx 
X X X x 

X X x X 

xxx 

X X X X 

X X 

xxx 

X X 

XXX 

xxx 
xxx 
X X x x 

cfmtmutt 
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Instruction Meaning 


Chips 

88 286 386 486 87 287 387 


LODSB 

Load b\te from string to AL 

X 

X 

X 

X 

LODSD 

Load doubleword from string to 
LAX 



X 

X 

I.ODSVC* 

IxDad vuml from string to AX 

X 

X 

X 

X 

LOOP 

Loop 

X 

X 

X 

X 

LOOPL 

Loop 'v hi!-.- equal 

X 

X 

X 

X 

LOOPNE 

Loop while not equal 

X 

X 

X 

X 

LOOPNZ 

L<>op while not zero 

X 

X 

X 

X 

LOOP/. 

Loop while to 

X 

X 

X 

X 

LSL 

Load 'Cgintut lit: ;t 


X 

X 

X 

LSS 

Load SS rt gisi r 



X 

X 

LTR 

Load task register 


X 

X 

X 

MOV 

Move 

X 

X 

X 

X 

MOVSB 

Move string byte-by-byte 

X 

X 

X 

X 

MOVSD 

Move string doubleword- 
by-doublcword 



X 

X 

MOVSW 

Move string word-by-word 

X 

X 

X 

X 

MOVSX 

Move with sign extended 



X 

X 

MOVZX 

Move with zero extended 



X 

X 

MUL 

Multiply * • 

X 

X 

X 

X 

NEG 

Negate 

X 

X 

X 

X 

NOP 

No operation 

X 

X 

X 

X 

NOT 

Logical NOT 

X 

X 

X 

X 

OR 

Logical OR 

X 

X 

X 

X 

OUT 

Output to port . 

X 

X 

X 

X 

OUTS 

Output string to port 


X 

X 

X- - 

OUTSB 

Output string byte to port 


X 

X 

X 

Ol.'TSD 

Output string doubleword to port 



X 

X 

oursvx 

Output string word to port 


X 

X 

X 

i'l )P 

Remove data from stack 

X 

X 

X 

X 
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Instruction 

Meaning 

POPA 

POP all general registers 

POPAD 

POP all general doubleword 
registers 

POPF 

Remove flags from stack 

POPFD 

Remove extended flags from sta 

PUSH 

Place data on stack 

PUSHA 

Push all general registers 

PUSHAD 

Push all general doubleword 
registers 

PUSHF 

Place flags on stack 

PL’SHFD 

Place extended flags on stack 

RCL 

Rotate left through carry 

RCR 

Rotate right through carry 

REP 

Repeat 

REPE 

Repeat if equal 

REPNE 

Repeat if not equal 

repnz 

Repeat if not zero 

REPZ 

Repeat if zero 

RET 

Return from subroutine 

ROL 

Rotate left 

ROR 

Rotate right 

SAHF 

Store AH into flags register 

SAL 

Arithmetic shift left 

SAR 

Arithmetic shift right 

SBB 

Subtract with carry 

SCASB 

Scan string for byte 

SCASD 

Scan string tor doubleword 

SCASW 

Scan string for word 

SETA 

Set byte if above 

SETAE 

Set byte if above or equal 

SETB 

Set byte if belo" 

''I l BE 

Set byte .f below or cqu '> 


Chips 

SH 286 .186 4 86 87^ 28~ > 38 7 
XXX 

x X 

x X X X 

x X 

x X X X 
XXX 
X X 

X X X X 

x X 

X X X X 

X X X X 

X X X X 

X X X X 
X X X X 

X X X X 
X X X X 

X X X X 
X X x X 

X X X X 

x X X X 
X X x X 
x X X X 

x X X X 

• X XXX 

X x 

X X X X 

x X 

x X 

X X 

x X 

cuntimtti 
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"74.4- Hart IV 

Reference 




Table . 

22. 1 . continued 





Chips 

- 

Instruction Meaning 

88 286 386 486 87 

287 38 7 

SHTC 

Set byte on carry 

X X 


SETE 

Set byte if equal 

X X 


SETG 

Set byte if greater 

X X 


SETGE 

Set byte if greater or equal 

X x 


SETL 

Set b\ie if less 

X X 


SETLE 

Set byte if less or equal 

X X 


SETNA 

Set byte if not above 

X X 


SETNAE 

Set byte if not above or equal 

X X 


SETNB 

Set byte if not below 

X V 


SETNBE 

Set b)ie if not below or equal 

X X 


SETNC 

Set byte on no carry 

X X 


SETNE 

Set byte if not equal 

X X 


SETNG 

Set byte if not greater 

X X 


SETNGE 

Set byte if not greater or equal 

X X 


SETS'L 

Set byte if not less 

X X 


SETNLE 

Set byte if not less or equal 

X X 


SETNO 

Set byte on no overflow 

X x 


SETNP 

Set byte on no priority 

X X 


SETNS 

Set byte on not sign 

X x 


SETNZ 

Set byte if no; zero 

X X 


SETO 

Set b\ re on overflow 

X x 


SFTP 

Set byte on parity 

X X 


SFTPE 

Set byte on parity even 

X x 


SK1PO 

Set byte on parity odd 

X x 


sins 

Set byte on sign 

X x 


SETZ 

M*t b\tc if zero 

X X 

• 

SGDT 

More C.f>7 register 

Xxx 


SHL 

Shift left 

x X X X 


SMLD 

Shift left, double precision 

X x 


SHR 

Shift right 

X X X X 
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t 


Cbif/s 


Instruction 

Meaning 

H8 

286 

386 

486 87 287 387 

SURD 

Shift right, double precision 



X 

X 

SIDT 

Store IDT register 


X 

X 

X 

SLOT 

Store LOT register 


X 

X 

X 

SMSW 

Store machine status word 


X 

X 

X 

STC 

Set carry flag 

X 

X 

X 

X 

STD 

Set direction flag 

X 

X 

X 

X 

STl 

Set interrupt flag 

X 

X 

X 

X 

STOSB 

Store byte in AL at string 

X 

X 

X 

X 

STOSD 

Store doubleword in EAX at string 



X 

X 

STOSVf 

Store word in AX at string 

X 

X 

X 

X 

SIR 

Store task register 


X 

X 

X 

si;b 

Subtract 

X 

X 

X 

X 

TEST 

Test bits 

X 

X 

X 

X 

VERR 

Verify segment for reading 


X 

X 

X 

VERW 

Verify segment for writing 


X 

X 

X 

WAIT 

Wait 

X 

X 

X 

X 

WBINVD 

Invalidate cache and write back 




X 

XADD 

Exchange and add to memory 




X . 

XCHG 

Exchange 

X 

X 

X 

X 

XLAT 

Translate 

X 

X 

X 

X 

XOR 

Logical XOR 

X 

X 

X 

X 


Specialized Registers: Flags, 
Control, and Status 


Most Instructions either control or change the status ofthe any 

specialized registers used by the microprocessor or the NPX/FPU. These special 


registers include the following 

□ Flags register 

□ Control word 
■J Status word 
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™nri?To2'S 


words apply- 

on the instruction and results t»l the instruction. 


The Flags Register 


Each of .he Intel microprocessors uses a flags register to ideate the «atus of 
operations. These flags can be tested to control program execution. or the) can be 
set to control certain tasks performed by the microprocessor. 

The <ze of the flags register depends on the microprocessor. For instance, the 
8086/8088 and 80286 use a 16-bit flags register, but the 80386 and 80486 both use 
32-bit flags registers. However, not every bit is always used. Table 22.2 details how 
each bit is used by each microprocessor. 


Table 22.2. The flags register. 

Bits 

Code 

Use 

88 

Microprocessor 

286 386 486 

0 

CF 

Carry 

X 

X 

X 

X 

2 

PF 

Parity 

X 

X 

X 

X 

4 

AF 

Auxiliary carry 

X 

X 

X 

X 

6 

ZF 

Zero 

X 

X 

X 

X 

7 

SF 

Sign 

X 

X 

X 

X 

8 

TF 

Trap 

X 

X 

X 

X 

9 

IF 

Interrupt 

X 

X 

X 

X 

10 

DF 

Direction 

X 

X 

X 

X 

11 

OF 

Overflow 

X 

X 

X 

X 

12*13 

lOPL 

I/O privilege level 


X 

X 

X 

14 

NT 

Nested task 


X 

X 

X - 

16 

RF 

Resume 



X 

X 

17 

VM 

Virtual mode 



X 

X 

18 

AC 

Alignment check enabled 




X 


Not.cc that although the 8086/8088 defines only 9 bits, Intel found it neccssarv 
...define more bus with each succeeding generation of microprocessor: the 80286 

uses 11. the K.b86 uses 13 and the 80486 uses 14 bits. All other bus in the flags 
register remain reserved and undrAn.-H Ku i__ -, , , ^ 

lions after t \\ hick. bit*, m the flags recister InJ ^ w 3 $ Which ' nStrUC ' 

are omitted from this • an| c . 8 * inslru ««ons that have no effect on the flags 
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Table 22.3. How Instructions affect t be flags register. 
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30 W' 




55 


T 5 

N < 

5; 


» 


1 

1 


X 

X 

X 

X 

X 



X 

X 

X 

X 

X 

r\. 

fS. 

X 


#%• 

X 

X 


X 

X 

X 

^ u* 














X 



I* 5 * 













X 

X 



"coR 













X 

X 



7 

SF 

X 

X 

X 

X 

X 

X 

X 

X 


rv. 

#*• 

X 


X 

fS.. 

X 

VO Ni 

X 

X 

X 

X 

X 

X 

X 

X 

ft. 

A. 

A. 

X 


X 

A- 

X 


X 

X 

X 

X 

X 

X 

X 

X 


e%. 


X 


X 

r% 

X 

<N 

X 

X 

X 

X 

X 

X 

X 

X 

e%. 

A. 

A. 

X 


X 

A- 

X 

0 

CF 

X 

X 

X 

X 

X 

X 

X 


#*« 

A. 

X 



X 

X 

X 


fc 

«« 

c. 

E 

o 

u 


o 

£ 

£ 

^ £ 

a & 

c c 

£ 'S-g 

e sj I 

R fl U 

c. c. -r 

E 6 •§ 
coo 
u u *o 


a o 
£ £ 
z z 

u u u 


Q. 

5 


JS* 

& 

c 

s 

K 

EL 

E 

3 


s* 

t/: 

c_ 

s 

(J 


& 

g 

I 

5 

I 

ft 

a 

n 

C- 

E 

c 

u 


X 

c- 

s 

u 


£ £ 


tA 

3 

5* 


•s S 
E 2 
C-5 
■o 

tt 


i/i 

a 

*5* £ 

ft o 


in 


5 5 
E E 

1A 


c 

o 

E CJ 
Si 3 

5 :s 

2 Q 


*3 

> 

^5 

u 

Sc 

u 


>s 

cL 

"5 

E 

u 

& 

w 

c 


'w» 

E 

P 

u 

C 


2 

c 


V. w 


2 y 

<t z 


Scanned by CamScanner 


•NT Software interrupt 

I RET Return from interrupt 

MUI. Multiply 

NEG Negate 




Instruction 


^ XX 
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Table 22.3 . continued 
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The Control Word 


All Che Incel NI'X chips, (including che FPU on the 80486) use a control word 
,o govern how the chip works, llach of the 16 bits in this word has a different use. 
Tabic 22.4 details how each bit is used in each type of NPX or FPU. 


Table 22.4. 

The NPX/FPL' control tvord. 






Bits 

Code 

Use 

NPX/FPU 
87 287 

387 

486 


0 

1M 

invalid operation 

X 

X 

X 

X 


1 

DM 

Denormalized operand 

X 

X 

X 

X 


2 

ZM 

Zero divide 

X 

X 

X 

X 


3 

OM 

Overflow 

X 

X 

X 

X 


4 

CM 

Underflow 

X 

X 

X 

X 


5 

PM 

Precision 

X 

X 

X 

X 


6 


Reserved 






7 

IEM 

Interrupt enable mask 

X 







0 = Enabled 








1 =• Disabled 






8-9 

PC 

Precision control 

X 

X 

X 

X 




00 = 24 bits 

X 

X 

X 

X 




01 = Reserved 

X 

X 

X 

X 




10 = 53 bits 

X 

X 

X 

X 




11 = 64 bits 

X 

X 

X 

X 


10-11 

RC 

Rounding control 

X 

X 

X 

X 




00 = Nearest or even 








01 = Down 





% 

s 



10 = Up 








11 = Truncate 






12 

1C 

Infinity control 

X 

X 






0 = Projective 








1 = Affine 






13-15 


Reserved 
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To change the vaJues in this word, you must construct it tn memory and then 
specific mnemonic instructions to direct it to be stored in the NPX FPL These 
instructions are covered later in this section. 


The Status Word 

The NPX/FPU family uses a status word to describe the current condition of 
the coprocessor. This 16-bit register contains a series of bits that reflect the result of 
recent numeric operations. The first 6 bits (0 through 5) are exception flags; they are 
set when an exception occurs. Compare these flags to the similar flags in the NPX/ 
FPU control word that govern whether exceptions for the individual conditions are 
trapped. 

Table 22.5 defines the status word and how it is used among the members of 
the NPX/FPU family. 

Notice the different use of bits across generations of NPX FPU. In particular, 
the use of bits 6 and 7 has changed. For the 8087 and 8028'. bit 6 was considered 
reserved; it was defined starting with the 8G387. The designation and use of bit 7 
changed entirely from the 8087 to the 80287. 

Regardless of how the NPX/FPU uses it, the status word cannot be examined 
directly. To analyze the status word, you must first transfer it to memory. 

The bits of the 8087, 80287, 80387, and 80486 numeric processor starus 
words are affected by various instructions, as shown in table 22.6 Because bits 6 and 
7 of the status word are defined differently from one model of numeric processor 
to the next, there are two columns for bit 7. 
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Table 22. 5. 77?c NPX/FPU status word. 

Status Word 

Bits Code 

Use 

NPX/FPU 
87 287 

387 

486 

0 

IE 

Invalid operation 

X 

X 

X 

X 

1 

DE 

Denormalized operand 

X 

X 

X 

X 

2 

ZE 

Zero divide 

X 

X 

X 

X 

3 

OE 

Overflow 

X 

X 

X 

X 

4 

UE 

Underflow 

X 

X 

X 

X 

5 

PE 

Precision 

X 

X 

X 

X 

6 

SF 

Stack flag 



X 

X 

7 

1R 

Interrupt request 

X 




7 

ES 

Error summary sums 


X 

X 

X 

8 

CO 

Condition code 0 

X 

X 

X 

X 

9 

Cl 

Condition code 1 

X 

X 

X 

X 

10 

C2 

Condition code 2 

X 

X 

X 

X 

11-13 

ST 

Suck-top pointer 

X 

X 

X 

X 

14 

C3 

Condition code 3 

X 

X 

X 

X 

15 

B 

Busy signal 

X 

X 

X 

X 
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Table 22.6. How instructions affect tbe status tvord. 
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FSUB Subtract real 

FSUBP Subtract real and POP 

FSUBR Subtract real reversed 

FSUBRP Subtract real reversed 

and POP . 
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Detailed Instruction Information 

In the remainder of this chapter, each member of the Intel instruction set is 
described in detail. The following information is given for each instruction: 

□ Instruction name. This name is based on the standard mnemonic code 
designed by Intel. 

□ Applicable processors. This paragraph lists the processors that perform 
the instruction. 

□ Instruction category. The general classification for the instruction is 
provided. 

Q Flags affected. The majority of the instructions change the status of the 
bits in the flags register (or the status word, in the case of numeric proces¬ 
sor instructions). The individual flags affected are listed in this section. 

□ Coding examples. Brief examples of the use of the instruction are given. 

□ Description. A narrative description of each instruction is provided. 

The instructions are arranged in ascending alphabetical order. 


AAA: ASCII Adjust for Addition 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF, CF, OF (undefined), PF (undefined), SF (undefined), 
ZF (undefined) 

Coding example: 

AAA 

Description: AAA changes the contents of AL to a valid unpacked decimal number 
with the high-order nibble zeroed. 


AAD: ASCII Adjust for Division 

Applicable processors: 8086/8088, 80286, 80386, 80486 
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Category: Arithmetic instructions 

Flags affected: AF (undefined), CF (undefined), OF (undefined), PF, SF, ZF 
Coding example: 

AAD 

Description: AAD multiplies the contents of AH by 10, adds the result to the contents 
of AL, and places the result in AL. The instruction then sets AH to 0. You use this 
instruction before you divide unpacked decimal numbers. 


AAM: ASCII Adjust for Multiplication 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF (undefined), CF (undefined), OF (undefined), PF, SF, LF 
Coding example: 

AAM 

Description: After multiplying two unpacked decimal numbers, you use AAM to 
correct the result to an unpacked decimal number. For the instruction to work 
properly, each number multiplied must have had its high-order nibbles set to 0. 


AAS: ASCII Adjust for Subtraction 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF, CF, OF (undefined), PF (undefined). SF (undefined). 
ZF (undefined) 

Coding example: 

AAS 

Description: AAS corrects the result of a previous unpacked decimal subtraction 
so that the value in AL is a true unpacked decimal number. 
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ADC: Add with Carry 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 
Flags affected: AF, CF, OF, PF, SF, ZF 
Coding examples: 


ADC 

AX.BX 

;AX«AX+BX+CF 

ADC 

AX,TEMP 

;AX«AX+TEMP*CF 

ADC 

SUM,BX 

;SUM b SUM+BX+CF 

ADC 

CL,10 

;CL-CL+10+CF 

ADC 

AX,TEMP[BX] 

;Indirect address example 


Description: ADC adds the contents of the source operand to (and stores the result 
in) the destination operand. If the carry flag is set, the result changes m increments 
of 1. In this routine, the values being added are assumed to be binary. 


ADD: Add 

Applicable processors: 8086/8088,80286, 80386, 80486 
Category: Arithmetic instructions 
Flags affected: AF, CF, OF, PF, SF, ZF 
Coding examples: 


ADD 

AX.BX 

; AX*AX+BX 

ADD 

AX,TEMP 

;AX=AX+TEMP 

ADD 

SUM,BX 

;SUM=SUM+BX 

ADD 

CL,10 

;CL*CL>10 

ADD 

AX,TEMP(BX) 

;Indirect address example 


Description: add adds the contents of the source operand to (and stores the result 
in) the destination operand. In this routine the values being added are assumed to 
be binary. 


AND: Logical AND on Bits 

Applicable processors: 8086/8088, 80286, 80386, 80486 
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Category: Hit-manipulation instructions 

Flags affected: AF (undefined), CF, OF, PF, SF, ZF 

Coding examples: 


AND 

AX.BX 

j'Jsing two 16-bit registers 

AND 

AX,TEMP 

;1EMP must be a word 

AND 

SUM,BX 

;SUM must be a word 

AND 

CL,00001111b 

;Zoro high nibble 

AND 

AX,TEMP(BX) 

;Indirect address example 


Description: This instruction performs a logical AND of the operands and stores 
the result in the destination operand. Each bit of the resultant byte or word is set to 
1 only If the corresponding bit of each operand is set to 1. 


ARPL: Adjust RPL Field of Selector 

Applicable processors: 80286, 80386, 80486 

Category: Bit-manipulation instructions 

Flags affected: ZF 

Coding examples: 

ARPL SELECTOR,AX 

ARPL AX.CX 

Description: ARPL compares the RPL bits (bits 0 and 1) of the first operand with 
those of the second. If the RPL bits of the first operand are less than those of the 
second, the two bits of the first operand are set equal to the two bits of the second, 
and the zero flag is set. Otherwise, the zero flag is cleared. This instruction is used 
only in operating system software, not in applications software. 


BOUND: Check Array Index against Bounds 

Applicable processors: 80286,80386, 80486 
Category: Flag- and processor-control instructions 
Flags affected: None 
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Coding example: 

BOUND BX,LIMITS 

Description: BOUND determines whether the signed value in the first operand falls 
between the two boundaries specified by the second operand. The word at the 
second operand is assumed to be the lower boundary, and the following word is 
assumed to be the upper boundary. An interrupt 5 occurs if the value in the first 
operand is less than the lower limit or greater than the upper limit. 


BSF: Bit Scan Forward 

Applicable processors: 80386, 80486 

Category: Bit-manipulation instructions 

Flags affected: ZF 

Coding examples: 

BSF * EAX.TEMP 
BSF CX,BX 

Description: BSF scans the bits of the second operand (starting with bit 0) to see 
whether any are set. If all bits are clear (second operand is 0), the first operand is not 
changed, and the zero flag is set. If any bit is set, the zero flag is cleared, and the first 
operand is set equal to the bit number of the bit that is set. 


BSR: Bit Scan Reverse 

Applicable processors: 80386, 80486 

Category: Bit-manipulation instructions 

Flags affected: ZF 

Coding examples: 

BSR EAX.TEMP 

BSR CX,BX 

Description: BSR scans the bits of the second operand (starting with the high-order 
bit) to see whether any are set. If all bits are clear (second operand is 0) the firs 
operand is not changed, and the zero flag is set. If any bit is set, the zero flac is ci h 
and the first operand is set equal to the bit number of the bit that is set eared< 
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BSWAP: Swap 32-Bit Byte Order 

Applicable processors: 80486 

Category: Data-transfer instructions 

Flags affected: None 

Coding examples: 

BSWAP EAX 

BSWAP EDX 

Description: This instruction uses an extended (32-bit) register as an operand. It 
r reverses the byte order in the register. Byte 0 is swapped with byte 3, and byte 1 is 
swapped with byte 2. 


BT: Bit Test 

Applicable processors: 80386,80486 

Category: Bit-manipulation instructions 

Flags affected: CF 

Coding examples: 

BT TEMP,EAX 
BT BX.CX 

BT TEMP,3 ;Test 3rd bit 

Description: BT uses the value of the second operand as a bit index into the value 
of the first operand. The bit at the indexed position of the first operand is copied into 
the carry flag. 


BTC: Bit Test and Complement 

Applicable processors: 80386, 80486 
Category: Bit-manipulation instructions 
Rags affected: CF 
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Coding examples: 

BTC TEMPfEAX 

BTC BX.CX 

BTC TEMP,3 ;Opposite of 3rd bit 

Description: BTC uses the value of the second operand as a bit index into the value 
of the first operand. The opposite value of the bit at the indexed position of the first 
operand is copied into the carry flag. 


* i<“ j 


BTR: Bit Test and Reset 

Applicable p. cessors: 80386. 80486 
Category: Bit-manipulation instructions 
Flags affected: CF 
Coding examples: 


BTR 

TEMP.EAX 


BTP 

BX.CX 


BTR 

TEMP,3 

. ;Value of 3rd bit 


Description: BTR uses the value of the second operand as a bit index into the value 
of the first operand. The bit at the indexed position of the first operand is copied into 
the carry flag, and then the original bit value is cleared. 


BTS: Bit Test and Set 

Applicable processors: 80386, 80486 
Category: Bit-manipulation instructions 
Flags affected: CF 
Coding examples: 


BTS 

TEMP.EAX 


BTS 

BX.CX 


BTS 

TEMP.3 

’.Value of 3rd bit 


Description: BTS uses the value of the second operand as a bit index into the value 
of the first operand. The bit at the indexed position of the first operand is copied into 
the carry flag, and then the original bit value is set. 
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CALL: Perform Subroutine 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding examples: 


CALL 

WHIZ_BANG 

;.WHIZ_BANG is a'subroutine 

CALL 

IBX]” 

;Perform subroutine with address at [BXJ 

CALL 

AX 

{Subroutine address in AX 


Description: CALL does the following: 

□ Pushes offset address of following instruction on the stack 

□ If procedure being called is declared as FAR, pushes segment address of 
following instruction on the stack 

□ Loads IP with the offset address of the procedure being called 

□ If procedure being called is declared as FAR, loads CS with the segment 
address of the procedure being called 

Execution then continues at the newly loaded CS:IP address until a RET 
instruction is encountered. 


CBW: Convert Byte to Word 

Applicable processors: 8086/8088, 80286,80386, 80486 
Category: Arithmetic instructions 
Flags affected: None 
Coding example: 

CBW 

Description: CBW converts the byte value in AL to a word value in AX by extending 
the high-order bit value of AL through all bits of AH. 
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CDQ: Convert Doubleword to 

Applicable processors: 80386, 80486 


Quadword 


Category: Arithmetic instructions 


Flags affected: None 
Coding example: 

CDQ 

Description: CDQ converts the doubleword value in EAX to a quadword value in 
EDX:EAX by extending the high-order bit value of EAX through all bits of EDX. 


CLC: Clear Carry Flag 

Applicable processors: 8086/8088, 802C5, 80386,80486 
Category: Flag- and processor-control instructions 
Flags affected: CF 
Coding example: 

CLC 

Description: CLC clears the flags register’s carry flag by setting it to 0. 


CLD: Clear Direction Flag 

Applicable processors: 8086/8088, 80286, 80386,80486 
Category: Flag and processor-control instructions 
Flags affected: DF 
Coding example: 

CLD 

Description: CLD clears the direction flag of the flags register by setting the flag 
to 0. 


4 


Scanned by CamScanner 


CLI: Clear Interrupt Flag 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Flag- and processor-control instructions 
Flags affected: IF 
Coding example: 

CLI 

Description: CLI clears the interrupt flag of the flags register by setting the flag 
to 0. While the interrupt flag is cleared, the CPU recognizes no maskable interrupts. 


CLTS: Clear Task-Switched Flag 

Applicable processors: 80286, 80386, 80486 
Category: Flag- and processor-control instructions 
Flags affected: None 
Coding example: 

CLTS 


Description: CLTS clears the task-switched flag of the machine status word (MSW). 
This instruction is used only in operating system software, not in applications 
software. 


CMC: Complement Carry Flag 

Applicable processors: 8086/8088,80286, 80386,80486 
Category: Flag- and processor-control instructions 
Flags affected: CF 


Coding example: 


CMC 


Description: CMC switches the carry flag of the flags register to the opposite of the 
fla 8's current setting. 
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CMP: Compare 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 
Rags affected: AF, CF, OF, PF, SF, ZF 
Coding examples: 


CMP 

AX,BX 

{Compare two 16-bit registers 

CMP 

AX,TEMP 

;TEMP must be a word 

CMP 

SUM,EBX 

;SUM must be a doubleword 

CMP 

CL,3 

{.Compare to constant 

CMP 

AX,TEMP[BX] 

{Indirect address example 


Description: CMP is considered an arithmetic instruction because the source* 
operand is subtracted from the destination operand. The result is not stored 
anywhere, however; it is used for setting the flags. You can use subsequent testing 
of the flags For program control. 


CMPSB: Compare Strings, Byte-for-Byte 

Applicable processors: 8086/B088, 80286, 80386, 80486 

Category: String-manipulation instructions 

Flags affected: AF, CF, OF, PF, SF, ZF 

Coding examples: 

CMPSB {Compare strings 

REPE CMPSB {Repeat a comparison loop 

Description: cmpsb compares strings, byte-by-byte. DI and SI change in increments 
or decrements of 1, depending on the setting of the direction flag. Ordinarily,'this 
instruction is used with the REPE, REPNE, REPNZ, or REPZ instructions to repeat the 
comparison for a maximum of CX number of bytes. Intel lists this command as CMP8, 
but the assembler makes the byte (CMPSB) and word (Cmpsw) distinctions. This 
instruction affects only the flags; no changes are made to the operands. 


CMPSD: Compare Strings, Doubleword-for-Doubleword 

Applicable processors: 80386, 80486 
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Category: Stringmanipulation instructions 
Hags affected: AP. CF, OF |>F. SF ZF 
Coding examples: 


CMPSD 

REPE CMPSD 


•Compare strirgs 
iRepeat a comparison loop 


doubleword-for-doublcword. ED, and ESI 

direction flag Usually, this instruction is used wuh^VT mpmVe ™" 8 
instructions to repeat the comoar.snn ,k . u f ’ E NEl REPNZ - or REPZ 

instruction affects only the flags; no change's aTmadc 'io'the^e^ndi" ^ 1 ** 


CMPSW Compare Strings, Word-for-Word 

Applicable processors: 8086/8088. 80286. 80386. 80486 
Category’: String-manipulation instructions 
Flags affected: AF, CF, OF, PF, SF. ZF 
Coding examples: 


CMPSW 
REPE CMPSW 


•Compare strings 
;Repeat a comparison loop 


^r p ord n ec~°x e : s r^d wordfor r rd di and si ^*— 

Ordinarily, this instrualon is used along w ,?h Mr! o'Jz'™™ " ag 

“ comparison for the number of 

command as CMPS, but the assembler makes the bvie (curse, "l,,,? 

STT ~ “ *“ -> - ~ 25/“SS 



CMPXCHG: Compare and Exchange 

Applicable processors: 80486 
Category: Arithmetic instructions 
Hags affected: AF, CF. OF. PF. SF. ZF 


769 
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Coding example: 

CMPXCHG ECX.EBX.EAX 
CMPXCHG CL.CH.Al 

Description: As you can sec from the coding examples, this instruction uses three 
operands, all three of which must be the same size. They are (in order) the source, 
destination, and accumulator operands. This instruction tests the destination 
against the accumulator—if they are equal, the value of the source is loaded into the 
destination; if they are unequal, nothing is changed (except ZF is cleared). 


CWD: Convert Word to Doubleword 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 
Flags affected: None 
Coding example: 

CWD 

Description: CWD converts the word value in AX to a doubleword value in DX*AX by 
extending the high-order bit value of AX through all bits of DX. 


CWDE: Convert Word to Extended Doubleword 

Applicable processors. 80386,80486 
Category: Arithmetic instructions 
Flags affected: None 
Coding example: 

CWDE 

Description: CWDE converts the word value in AX to a doubleword value in EAX bv 
extending the high-order bit value of AX through the remaining bits of EAX 
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DM: Decimal Adjust for Addition 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF, CF, OF (undefined for all processors through 80286, not affected 
beginning with 803.86), PF, SF, ZF 

Coding example: 

0AA 

Description: DAA corrects the result (AL) of a previous binary-coded decimal (BCD) 
addition operation. 


DAS: Decimal Adjust for Subtraction 

Applicable processors: 8086/8088,80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF, CF, OF (undefined for all processors through 80286, not affected 
beginning with 80386), PF, SF, ZF 

Coding example: 

DAS 

Description: DAS corrects the result (AL) of a previous binary-coded decimal (BCD) 
subtraction operation. 


DEC: Decrement 

Applicable processors: 8086/8088,80286, 80386, 80486 
Category: Arithmetic instructions 
Flags affected: AF, OF, PF, SF, ZF 
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Coding examples: 

DEC AX 

DEC ECX 

DEC SUM 

DEC CL 

DEC TEMPI SI) 

Description: DEC changes, in decrements of 1, the contents of the operand. The 
operand is assumed to be an unsigned binary value. 

DIV: Divide 

Applicable processors: 8086/8088. 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF (undefined), CF (undefined), OF (undefined), PF (undefined), 
SF (undefined), ZF (undefined) 

Coding examples: 


DIV 

BX 

;AX=DX:AX/BX 

DIV 

W0RD_TEMP 

;AX=DX:AX/W0RD_TEMP* 

DIV 

BYTE_$UM 

;AL=AX/BYTE_SUM 

DIV 

DW0RD_SUM 

;EAX=EDX:EAX/DW0RD_SUM 

DIV 

W0RD_TBI[BX) 

; Indirect address example 


Description: if the operand is a byte value, DIV divides the contents of AX by the 
contents of the operand and stores the result in AL and the remainder in AH. If the 
operand is a word value, DIV divides the contents of DX AX by the contents of the 
operand and stores the result in AX and die remainder in DX. 

For the 80386 and 80486, if the operand is a doubleword value, DIV divides the 
contents of EDX EAX by the contents of the operand and stores the result in EAX and 
the remainder in FDX. 

This instruction treats numbers as unsigned binary values. 


ENTER: Make Stack Frame for Procedure Parameters 

Applicable processors: 80286, 80386. 80486 
Category: Flag- and processor-control instructions 
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Flags affected: None 

Coding examples: 

ENTER PPTR.3 

ENTER CS:BX,« 

Description: ENTER modifies the stack appropriately for entry to a high-level 
language procedure. The first operand specifies the number of bytes of storage to 
be allocated on the stack; the second operand specifies the nesting level of the 
routine. The effects of this instruction are undone by the LEAVE instruction. 


ESC: Escape 

Applicable processors: 8086/8088, 80286, 80386, 80486 

Category: Flag- and processor-control instructions 

Flags affected: None 

Coding examples: 

ESC 6,TEMP 

ESC 15.CL 

Description: ESC prorides a means for coprocessors (such as the NPX/FPU) to 
access data in the microprocessor data stream. When this instruction is encountered, 
it causes the microprocessor to place the operand on the data bus and perform a 
NOP internally. 


F2XM1: 2 X -1 

Applicable processors: 8087, 80287, 8038?. 80486 
Category: Transcendental instruction 
Status affected: PE, UE 
Coding example: 

P2XMI 
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• poyui calculates Y=2*-l. where X is the top stack clement (ST). The 

SvJ replaces X as .he .op suck dement (ST). This ins.mc,ion performs no 
validation checkrng of .he input value The program ensures <ha. 0< -X< -0.5. 


FABS: Absolute Value 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: IE 
Coding example: 


FABS . - 

Description: FABS changes the top stack clement (ST) to its absolute value. 



FADD: Add Real 


Applicable processors: 8087, 80287, 80387, Sc-ib6 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE 


Coding examples: 


FADD TEMP ;ST=ST«TEMP 

*ADD TEMP,ST(3) ;TEMP=TEMP+ST(3) 


Description: FADD adds two numbers together and stores them at the destination 
operand. If no destination operand is given (only one operand is specified), ST is the 
assumed destination. 


FADDP: Add Real and POP 

Applicable processors: 8087. 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE 


Scanned by CamScanner 



Chapter 22 



Processor Instruction Sets 


775 


Coding examples: 


FAODP 

FAOOP 


TEMP 
TEMP,ST(3) 


;ST-ST *TEMP 
;TEMP=TEMP*ST(3) 


rt «rrintion- fAOOP adds wo numbers together, stores them a. the des.tnat.on 
opcramh'and pops the stack l( no destination operand is given (only one operand 
IS Specified), ST is the assumed destination. 


FBLD: BCD Load 

Applicable processors: 8087. 80287. 80387, 80486 
Category: Data-transfer instruction 
Status affected: IE 
Coding example: 

Dcscription^FBLD converts the BCD number a, the operand address to a temporary' 
real and pushes it on the stack. 


FBSTP: BCD Store and POP 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Data-transfer instruction 

Status affected: IE 
Coding example: 

FBSTP TEMP inteeer. stores it 

at the operand address, and pops the suck. 


FCHS: Change Sign 

Applicable processors: 8087,8028 . 


80387, 80486 
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Category: Arithmetic instruction 
Status affected: IE 
Coding example: 

FCHS 

Description: FCH$ changes the sign of the.top stack element (ST). 


FCLEX: Clear Exceptions with WAIT 

Applicable processors: 8087, 80287, 80387. 80 486 
Category: Flag- and processor-control instructions 
Status affected: B. DE. IE, IR, OE, PE, UE, ZE 
Coding example: 

FCLEX 

Description: FCLEX clears the exception flags, interrupt request, and busy flags of 
the NPX/FPU status word. A CPU wait prefix precedes this instruction. See also 


FCOM: Compare Real 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Comparison instruction 
Starus affected: CO, C2, C3, DE, IE 
Coding examples: 

FCOM {Compare ST to ST(1) 

FCOM ST (4) {Compare ST to ST(4) 

FCOM TEMP {Compare ST to memory 

Description: The top stack element (ST) is compared to the second stack element 
(ST< 1)) or another specified operand. Condition codes are affected accordingly. 
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FCOMP: Compare Real and POP 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Comparison instruction 
Status affected: CO, C2. C3. DE, IE 
Coding examples: 

FC0MP ;Compare ST to ST(i) 

FCOMP 3T(4) ;Compare ST to ST( 4 ) 

FCOMP TEMP ;Compare ST to memory 

Description: The top stack element (ST) is compared to the second stack element 

(ST(1)) or another specified operand; the stack is then popped Condition codes are 
affected accordingly. 

FCOMPP: Compare Real and POP Twice 

Applicable processors: 8087, 80287, 80387, 80486 
Category': Comparison instruction 
Status affected: CO, C2, C3, DE, IE 
Coding example: 

FCOMPP ;Compare ST to ST(1) 

Description: The top stack element (ST) is compared to the second stack element 
(ST(1)) and the stack is popped twice. Condition codes are affected accordingly. 


FCOS: Cosine 


Applicable processors: 80387. 80486 
Category*. Transcendental instruction 
Status affected: DE. IE. PE, UE 
Coding example: 

'.Replace value in radians with cosine 

Inscription: The top stack element (ST) is replaced with its cosine, considering the 
c ement to be an an gj c j n radians. Condition codes are affected accordingly. 
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FDECSTP: Decrement Stack Pointer 

Applicable processors: 8087, 802H7, 80387, 80486 
Category: Flag- and process'or-control instructions 
Status affected: ST 


Coding example:, ' ^ • 

FDECSTP 

Description: FDECSTP decrements the stack pointer of the NPX/FPU status word. 

FD1SI: Disable Interrupts with WAIT , 

Applicable processors: 8087 

Category: Flag- and processor-control instructions 

Status affected: None 

Coding example: 

FDISI 

Description: FDISI sets the interrupt-cnablc mask of the 8087 control word, thus 
preventing the 8087 from initiating an interrupt. A CPU wait prefix precedes this 
instruction. See also FNOISI. 

FDIV: Divide Real 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE, ZE 
Coding examples: 

FDIV TEMP ;ST-TEMP/ST 

FDIV TEMP,ST(3) ;TEMP*ST(3)/TEMP 

Description: fdiv divides the destination by the source operand and stores the 
result at the destination operand. If no destination operand is given (only one 
operand is specified), ST is the assumed destination. 
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FDIVP: Divide Real and FOP 

Applicable processors: 8087. 80287, 80387. 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE. UE, ZE 
Coding examples: 

FOIVP TEMP ;ST=TEMP/ST 

FDIVP TEMP, ST (3) ;TEMP*=ST(3)/TEMP 

Description: FOIVP divides rhe destination by the source operand, stores the result 
at the destination operand, and pops the stack. If no destination operand is given 
(only one operand is specified). ST is the assumed destination. 


FDIVR: Divide Real Reversed 

Applicable processors: 8087. 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE, ZE 


Coding examples: 


FDIVR TEMP ;ST«ST/TEMP 

FDIVR TEMP, ST (3) ;TEMP«=TEMP/ST(3) 


Description: FDIVR divides the source by the destination operand and stores the 
result at the destination operand. If no destination operand is gi ( 
operand is specified), ST is the assumed destination. 



FDIVRP: Divide Real Reversed and POP 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE, ZE 
Coding examples: 

FDIVRP TEMP ;ST»ST/TEMP 

FDIVRP TEMP,ST(3) ;TEMP*TEMP/ST(3) 
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n-„ rriDI ion F0ivm> divides (he source by the destination operand, stores the result 
^e destination operand, and pops the stack, if no destination operand is Riven 
(only one operand is specified), ST is the assumed destination. 


FENI: Enable Interrupts with WAIT 

Applicable processors: 8087 

Category: Flag- and processor-control instructions 

Status affected: None 

Coding example: 

FfcNI 

Description: FENI clears the interrupt-enable mask of the 8087 control word, so 
that the 8087 can initiate interrupts. A CPU wait prefix precedes this instruction. See 
also FNENI. 


FFREE: Free Register 

Applicable processors: 8087, 80287, 80387, 80486 


Category: Flag- and processor-control instructions 

Status affected: None 
Coding example: 


FFREE ST(3) 


Description: ffree changes the tag for the specified stack register to indicate that 
the stack register is empty. 


F1ADD: Integer Add 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE. OE, PH 
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Coding examples: 

FI ADD TEMP ;ST=ST+TEMP 

FI ADD TEMP,ST(3) ;TEMP=TEMP+ST<3) 

Description: FI ADD adds two numbers together as integers and stores them at the 
destination operand. If no destination operand is given (only one operand is 
specified), ST is the assumed destination. 


FICOM: Integer Compare 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Comparison instruction 
Status affected: CO, C2, C3, DE, IE 
Coding example: 

FICOM TEMPINT ;Compare memory to ST 

Description: FICOM converts the operand (assumed to be an integer) to a temporary 
real and compares it to the top stack element (ST). Condition codes are set 
accordingly. 


FICOMP: Integer Compare and POP 

Applicable processors: 8087, 80287, 80387,80486 
Category.; Comparison instruction 
Status affected: CO, C2, C3, DE, IE 
Coding example: 

FICOMP TEMP_INT ;Compare memory to ST 

description: FICOMP converts the operand (assumed to be an integer) to a tempo- 
rar y real, compares it to the top stack element (ST), and then pops the stack. 
Condition codes are set accordingly. 
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F1DIV: Integer Divide 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Arithmetic Instruction 

Status affected: DE, IE, OE, PE, UE, ZE 

Coding examples: / 

FIDIV TEMP ;ST*TEMP/ST 

FIDIV TEMP,ST(3) ;TEMP«ST(3)/TEMP 

Description: FIDIV divides the destination by the source operand, as integers, and 
stores the result at the destination operand. If no destination operand is given (only 
one operand is specified), ST is the assumed destination. 


FIDIVR: Integer Divide Reversed 

Applicable processor: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE, ZE 

Coding examples: 

FIDIVR TEMP ;ST=ST/TEMP 

FIDIVR TEMP,ST(3) ;TEMP=TEMP/ST(3) 

Description: FIDIVR divides the destination by the source operand, as integers, and 
stores the result at the destination operand. If no destination operand is given (only 
one operand is specified), ST is the assumed destination. 


FILD: Integer Load 

Applicable processors: 8087, 80287, 80387,80486 

Category: Data-transfer instruction 

Status affected: IE 

Coding example: 

fild temp 


Scanned by CamScanner 


Description: FIID converts the binary integer number at the operand address to a 
temporary real and pushes it on the stack. • 


F1MUL: Integer Multiply 

^ r p nr.hl > processors: 8087,80287,80387,80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE 


Coding examples: 


FIMUL 

FIMUL 


TEMP 

TEMP,ST(3) 


;ST«ST*TEMP 

;TEMP«TEMP*ST(3) 


Description: fimul multiplies the source by the destination operard, as n e gets . 
and stores the result at the destination operand. If no destination operand « gnen 
(only one operand is specified), ST is the assumed destination. 


FINCSTP: Increment Stack Pointer 

Applicable processors: 8087,80287,80387,80486 
Category: Flag-and processor-control instructions 
Status affected: ST 
Coding example: 

FINCSTP 

Description: FINCSTP increments the suck pointer of the NPX/FPU sutus word. 



FINIT: Initialize Processor with WAIT 

Applicable processors: 8087, 80287,80387,80486 

Category: Flag- and processor-control instructions 

Status affected: None 
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Coding example: 

FINIT 

Description: FINIT initializes the NPX/FPU. This action is functionally equivalent to 
performing a hardware RESET. A CPU wait prefix precedes this instruction. See also 
FNINIT. 


FIST: Integer Store 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Data»transfer instruction 
Status affected: IE, PE 
Coding example: 

FIST TEMP 

Description: fist rounds the top suck element (ST) to a binary integer number and 
stores it at the operand address. 


FISTP: Integer Store and POP 

Applicable processors: 8087, 80287, 80387,80486 
Category: Dau*transfer instruction 
Status affected: IE, PE 
Coding example: 

FISTP TEMP 

Description: FISTP rounds the top suck element (ST) to a binary integer number, 
stores it at the operand address, and pops ST from the stack. 



FISUB: Integer Subtract 

Applicable processors: 8087, 80287, 80387, 80486 

Csuopoi y: Arithmetic instruction 
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Status affected: DE, IE, OE, PE 
Coding examples: 

FI SUB TEMP ' ;ST=ST-TEMP 

FISUB TEMP,ST(3) ;TEMP=TEMP-ST(3) 

Description: FISUB subtracts the source from the destination operand, as integers, 
and stores the result at the destination operand. If no destination operand is given 
(only one operand is specified), ST is the assumed destination. 


FISUBR: Integer Subtract Reversed 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE 
Coding examples: 

FISUBR TEMP ;ST=TEMP-ST 

FISUBR TEMP,ST(3) ;TEMP=ST(3)-TEMP 

Description: FISUBR subtracts the destination from the source operand, as integers, 
and stores the result at the destination operand. If no destination operand is given 
(only one operand is specified), ST is assumed to be the destination. 


FLD: Load Real 

4 V 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Data*transfer instruction 

Status affected: DE, IE 

Coding examples: 

FLD ST (3) 

PLD TEMP 

D«cription: fld pushes the value of the source operand on the stack. 
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FLD1: Load 1.0 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Constant instruction 
Status affected: IE 
Coding example: 

FLD1 

Description: FiDi pushes the value +1.0 on the stack. This value becomes ST. 


FLDCW: Load Control Word 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processorcontrol instructions 
Status affected: None 
Coding example: 

FLDCW MEM_CW ;Transfer control word 

Description: FLDCW loads the NPX/FPU control word with the word value pointed 
to by the source operand. 


FLDENV: Load Environment 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Flag- and processor-control instructions 

Status affected: B, CO, Cl, C2, C3, DE, ES, IE, IR, OE, PE, SF, ST, UE, 2E 

Coding example: 

FLDENV SAVE_AREA 

Description: FLDENV restores all environment variables of the NPX/FPU from the 
14-word memory location specified by the operand. 
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FLDL2E: Load log 2 e iJ(7 H 

Applicable processors: 8087, 80287, 80387, 80486 It >iiqqA 

Category: Constant instruction y-iojpieO 

Status affected: IE iflc ?rfirt? 

Coding example: cx-j %t \'>boj 

FLDL2E SMJQJ1 


Description: FL0L2E pushes the value of log 2 e on the stack. This value becomes ST. J 


FLDL2T: Load log 2 10 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Constant instruction 
Status affected: IE 
Coding example: 

FLDL2T 


oso) isan 

)DOiq oltfcoifqqA 

lJUt'noD 

31 ibsiasflf midi 

j^ntboO 

naji 


Description: FLDL2T pushes the value of log 2 10 on the stack. This value oecotnes ST. 




FLDLG2: Load log 2 

°io 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Constant instruction 
Status affected: IE 
Coding example: 

FLDLG2 


0.0 bROJ :XGLH 

_)8 :ano^«o30iq •jlth.oifqqA 
jDiniani incvnoD 
31 :Lj) 

•.alqrnKxo gniboJ 
SQJ3 


Description: FLDLG2 pushes the value of log )(j 2 on the srfifck. ,f fWs?va!hie bCC6hifcsST.^* 
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FLDLN2: Load log e 2 

Applicable processors: 8087, 80287, 80387, 80486 


Category: Constant instruction 
Status affected: IE 
Coding example: 

FLDLN2 

Description: FLDLN2 pushes the value of log e 2 on the stack. This value becomes ST. 

* • 

• • 

FLDPI: Load n • 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Constant instruction 
Status affected: IE 
Coding example: 

FLDPI 

Description: FLDPI pushes the value of k on the This value hrromet ST. 

FLDZ: Load 0.0 

Applicable processors: 8087,80287, 80387, 80486 
Category: Constant instruction 
Status affected: IE 
Coding example: 

FLDZ 

Description: FLDZ pushes the value 0.0 on the stack. This value ST. 
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FMUL: Multiply Real 

Applicable processor*. 8087, 80287. 80387, 80486 
Category; Arithmetic Instruction 
Statu* affected: DB, IE, OB, PE, IJE 
Coding example*: 

Ml TEMP ;8T-8T*TEMP 

FMUL TEMP,ST(3) ;TEMP-TEUP*8T<3) 

De*orftptftoa: FMUL multiplies the source by the destination operand and stores the 
result at the destination operand. If no destination operand is given (only one 
operand to specified), ST is the assumed destination. 


FMULP: Multiply Real and POP 

Applicable processor*: 8087,80287, 80387,80486 
C a t eg ory: Arithmetic instruction 

Status affected: DE, IE, ©E, PE, UE 
Coding examples: 

FMULP TEMP ;ST-ST*TEMP 

FMULP TEMP,8T(3) ;TEMP-TEMP*ST(3) 

Description: FMULP multiplies the source by the destination operand, stores the 
result st the destination operand, and pops the stack. If no destination operand is 
given (only one operand to specified), ST to the assumed destination. 


FNCLEX: Clear Exceptions 

Applicable processors; 8087,80287,80387,80486 
Category: Flag- and processor-control instructions 
Kfttu* affected: B. DE. IE, IR. OE. PE, UE, ZE 
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Coding example: 


FNCLEX 

Description: FNCLEX clears the exception flags, interrupt request, and busy flags of 
the NPX/FPU status word. This instruction is not preceded by a CPU wait prefix. See 
also FCLEX. 


FNDISI: Disable Interrupts 

Applicable processors: 8087 

Category: Flag- and processor-control instructions 

Status affected: None 

Coding example: 

FNDISI ’ * ***** 

Description: FNDISI sets the interrvnr-enable mask of the 8087 control word, thus 
preventing the 8087 from initiating an interrupt. This instruction is not preceded by 
a CPU wait prefix. See also FDISI. 


FNENI: Enable Interrupts hm 3 i»t 2 =t 2 ; 

Applicable processors: 8087 (£)T3*SM3T**tM3T; (C)T2,‘H43T iJlm-, 

?\ bnnaqo nou^niia^b on li jili eqoq one .brnnaqo notixun^b srij is jlurei 

Status affected*iNonp bam^ie *)ili u T2 2i bnxiaqo sno ylno) nsvig 

Coding example: 


FNENI 

prefix. See also FENI. 08*08 .V8£08 .V8S08 ,Y808 :«no22»3mq alcfejiiqqA 

znoit jLrutni Ionjno>io«*jjoiq bns -flfilH . 

kOHBBWH * 3U - 3<? .30 .3! ,31 3U .0 botjuTU: «uisl8 

FNINIT: Initialize Processor 

Applicable processors: 8087, 80287, 80J87. 80486 
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Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FNINIT 

Description: FNINIT initializes the NPX/FPU. This action is functionally equivalent 
to performing a hardware RESET. This instruction is not preceded by a CPU wait 
prefix. See also FINIT. 


FNOP: No Operation 

Applicable processors: 8087, 80287,80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FNOP 

Description: FNOP does nothing but take time and space; the NPX/FPU performs no 
operation. 


FNSAVE: Save State 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FNSAVE SAVE_AREA 

Description: FNSAVE saves, at the memory location specified by the °P^ ran ^’ ^ 
registers and environment variables of the NPX/FPU. This save requires 94 wo o 

memory. After the save, the NPX/FPU is initialized as though the FINIT or fni I 
instructions had been issued. This instruction (fnsave) is not precc c y 
wait prefix. See also FSAVE. 
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FNSTCW: Store Control Word 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None * 

. Coding example: 

FNSTCW MEM_CW ;Transfer control word 

Description: FNSTCW copies the NPX/FPU control word to the word value pointed 
to by the source operand. This instruction is not preceded by a CPU wait prefix. Sec 
also FSTCW. 


FNSTENV: Store Environment 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FNSTENV SAVE_AREA 

Description: fnstenv saves, at the memory location specified by the operand, all 
environment vanahles of the NPX/FPU. This save requires 14 words of memory. After 
the save, this instruction sets the exception masks of the NPX/FPU control word. This 
instruction is not preceded by a CPU wait prefix. See also FSTENV. 


FNSTSW: Store Status Word 

Applicable processors: 8087, 80287, 80387, 80486 . 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FNSTSW hemsw ;Transfer status word 
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Description: FNSTSW copies the NPX/FPU status word to the word value pointed to 
by the source operand. This instruction is not preceded by a CPU wait prefix See also 

FSTSW. 


FPATAN: Partial Arctangent 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Transcendental instruction 
Status affected: PE, UE 
Coding example: 

FPATAN 

Description: FPATAN computes 0ARCTAN(Y/X), where X is the top stack element 
(ST), and Y is the second stack element (ST(1)). Both stack elements are popped; 
the result (0) is pushed on the stack and becomes ST. This instruction performs no 
validation checking of the input value. The program ensures that 0<Y<X<«*. 


FPREM: Partial Remainder 

Applicable processors: 8087, 80287,80387,80486 
Category: Arithmetic instruction 
Status affected: CO, Cl, C3, DE, IE, UE 
Coding example: 

FPREM 

Description: FPREM calculates the modulo of the two top stack elements. By 
successively subtracting ST(1) from ST, this instruction calculates an exact remain - 
der and remains in ST. 
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FPREMI: Partial Remainder, IEEE version 

Applicable processors: 80387, 80486 
Category: Arithmetic instruction 
Status affected: CO. Cl. C2, C3, DE, IE. UE 
Coding example: 

FPREM1 

Description: fpremi calculates the modulo of the two top stack elements. Formula 
used is ST = ST - (ST(1) * quotient ). where quotient is the integer nearest the exact 
value ST/ST(1). If two integers arc equally dose, the even one is used. This formula 
is the only difference between fpremi and fprem. 

FPTAN: Partial Tangent 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Transcendental instruction 
Status affected: IE, PE 
Coding example: 

FPTAN 

Description: fptan computes Y/X=TAN(0), where 0 is the top stack element (ST). 
The top suck element is replaced by the computed Y, and the computed X is pushed 
on the stack. Thus, at the end of this operation, ST(1)-Yand ST»X. This instruction 
performs no validation checking of the input value. The program ensures that 
O<=0<=Jt 4. 


FRNDINT: Round to Integer 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Arithmetic instruction 
Status affected: IE. PE 
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Coding.example: 

FRNDINT 

Description: FRNDINT rounds the number in the top stack element (ST) to an 
integer. 


FRSTOR: Restore State 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Flag- and processor-control instructions 

Status affected: B, CO, Cl, C2, C3, DE, ES. IE, IR, OE, PE, SF, ST, UE, ZE 

Coding example: 

FRSTOR SAVE_AREA 

Description: FRSTOR restores all registers and environment variables of the NPX/FPU 
from the 94-word memory location specified by the operand. 


FSAVE: Save State with WAIT 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FSAVE SAVE_AREA 

Description: FSAVE saves, at the memory location specified by the operand, all 
registers and environment variables of the NPX/FPU. This save requires 94 words of 
memory. After the save, the NPX/FPU is ^ia^drfSjAiough the FINIT or FNINIT 
instructions had been issued. This instruction (FSAVE) is preceded by a CPU wait 
prefix. See also fnsave. ^ :boi3*»tn. w 

dqmcx*) gnilicO 

•friz rtJiw snsibsi nx »uIev 9.>gIit*R; 

^•anhabteiKW ,anie ai liliw bxwJq'Ji « (T2) snam*>B >!•>*)« qoi dHT :noi)qn >*><3 
tt&nitnoxME ns obco noiiibno.> znaibsi m nn oj jiv-mola 
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FSCALE: Scale 

Applicable processors: 8087, 80287? 80387,80486 


Category: Arithmetic Instruction 
Status affected: IE, OE, UE 
Coding example: 

FSCALE 

Description: fscale calculates X«X*2Y, where X b the value of the top stack 
clement (ST), and Y to the value of the second stack dement (ST(1)). 

FSETPM: Set Protected Mode 

Applicable processors: 80287 

Category: Flag- and processor-control instructions 

Status affected: None 

Coding example: 

FSETPM 

Description: fsetpm causes the 80287 to op er at e In p rotccied mode, Qt dln arf y, 
operation mode to of no concern to progra mmers of appbcaOom s oftw are crea sed 
in real mode. 

* « 

FSIN: Sine 

Applicable processors: 80387,80486 
Category: Transcendental instruction 
Status affected: DE, IE, PE, UE 
Coding example: 

FSIN ;Replace value In radians with sins 

Description: The top stack element ($T) to replaced with its sine, considering the 
element to be an angle in radians. Condition codes are effected im oidB^y . 
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FSINCOS: Sine and Cosine 

Applicable processors: 80387,80486 
Category: Transcendental instruction 
Status affected: DE. IE, PE. UE 
Coding example: 

FS1MC06 ;Replace value in radians with sins and coaina 

Description: The top stack element (ST) is replaced with Its sine, considering the 
element to be an angle in radians, tnd then the cosine is calculated and pushed onto 
the stack. Condition codes are affected accordingly. 


FSQRT: Square Root 

Applicable processors: 8087,80287,80387,80486 


Category: Arithmetic instruction 
Status affected: DE. IE, PE 


F80RT 

Description: FSQRT the square root of the top stack element (ST) and 

s tor es it as the new ST. The old ST is lost. 


FST: Store Real 

Applicable p r oce s so rs : 8087,80287,80387,80486 

Category: Daia-transfer instruction 

Status affected: IE, OE. PE, UE 

C odhtg examples: 

™ IT(I) 

F*T TfcBP 

ft—rriprhm: FST copies the value of the top stack element (ST) to the operand or 

°paandaddtcM. 
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FSTCW: Store Control Word with WAIT 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FSTCW MEMCW ;Transfer control word 

Description: FSTCW copies the NPX/FPU control word to the word value pointed to 
by the source operand. A CPU wait prefix precedes this instruction. See also FNSTCW. 


FSTENV: Store Environment with WAIT 

Applicable processors: 8087, 80287. 80387. 80486 
Category: Flag- and proc^osor-control instructions 
Status affected: None 
Coding example: 

FSTENV SAVEAREA 

Description: FSTENV saves, at the memory' location specified by the operand all 
environment variables of the NPX/FPU. This save requires 14 words of memory. After 
the save, this instruction sets the exception masks of the NPX/FPU control word A 
CPU wait prefix precedes this instruction. See also fnstenv 


_______ ’ , 

FSTP: Store Real and POP 

Applicable processors: 8087. 80287, 80387. 80486 
Category: Data-transfer instruction 
Status affected: IE, OE, PE, UE 
Coding examples: 

FSTP ST(3) 

FSTP TEMP 


Description: FSTP cop.es the value of the top stack element 
operand address and pops the stack 


(ST) to the operand or 
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FSTSW: Store Status Word with WAIT 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FSTSW MEM_SW ;Transfer status word 

Description: FSTSW copies the NPX/FPU status word to the word value pointed to 
by the source operand. A CPU wait prefix precedes this instruction. See also fnstsw. 


FSUB: Subtract Real 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Arithmetic instruction 

Status affected: DE, IE, OE, PE, UE 

Coding examples: 

FSUB TEMP ;ST=ST-TEMP 

FSUB TEMP,ST(3) ;TEMP=TEMP-ST(3) 

Description: FSUB subtracts the source from the destination operand, and stores the 
result at the destination operand. If no destination operand is given (only one 
operand is specified), ST is the assumed destination. 


FSUBP: Subtract Real and POP 

Applicable processors: 8087, 80287,80387,80486- 
Category: Arithmetic instruction 
Status affected: DE, IE, OE, PE, UE 
Coding examples: 

FSUBP TEMP ;ST=ST-TEMP 

FSUBP TEMP,ST(3) ;TEMP-TEMP-ST(3) 
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Description: FSUBP subtracts the source from the destination operand, stores the 
result at the destination operand, and pops the suck. If no destination operand is 
given (only one operand is specified), ST is the assumed destination. 


FSUBR: Subtract Real Reversed 

Applicable processors: 8087, 80287, 80387, 80486 

Category: Arithmetic instruction 

Status affected: DE, IE, OE, PE, UE 

Coding examples: 

FSUBR TEMP ;ST»TEMP-ST 

FSUBR TEMP,ST(3) ;TEMP«ST(3)-TEMP 

Description: FSUBR subtracts the destination from the source operand and stores 
the result at the destination operand. If no destination operand is given (only one 
operand is specified), ST is the assumed destination. 


FSUBRP: Subtract 4 Real Reversed and POP 

Applicable processors: 8087, 80287,80387, 80486 

Category: Arithmetic instruction 

Status affected: DE, IE, OE, PE, UE 

Coding examples: 

FSUBRP TEMP ;ST*TEMP-ST 

FSUBRP TEMP,ST(3) ;TEMP*ST(3)-TEMP 

Description: FSUBRP subtracts the destination from the source operand, stores the 
result at the destination operand, and pops the stack. If no destination operand is 
given (only one operand is specified), ST is the assumed destination. 


FTST: Test 

Applicable processors: 8087, 80287,80387, 80486 
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Category: Comparison instruction 
Status affected: CO, C2, C3, DE, IE 
Coding example: 

FTST 

Description: FTST compares the top stack clement (ST) to aero and sets the 
condition codes accordingly. 


FUCOM: Unordered Compare 

Applicable processors: Bu337, 80486 
Category: Comparison instruction 
Status affected: CO, C2, C3, DE, IE 
Coding example: 

FUCOM ; default comparison 

FUCOM ST (2) ;compara top and ST(2) 

Description: FUCOM compares the specified source with the top stack element (ST). 
If no operand is specified, fucom compares ST and ST(1). This instruction differs from 
fcom in that fucom does not cause an invalid operation exception if one of the 
operands is a NaN. Condition codes arc affected accordingly. 



FUCOMP: Unordered Compare and POP 

Applicable processor*! 80387,80466 
Category: Comparison Instruction 
Status affected: CO, C2, C?. DE, IE 
Coding example: 

FUCOMP jdafsult comparison 

FUCOMP ST(2) ;compart top and 8T(2) 

Description: fucomp compares the s|>eclfied source with the top stack element (37). 
If no operand is specified, FUCOMP compares ST i»nd ST(1). This Instruction differs 
from fcom in that FUCOMP does not cause an invalid operation exception If one of the 
operands is a NaN. Condition codes are affected accordingly. The stack is then 
popped one time. 

- , > . 

Vy * ' 
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FUCOMPP: Unordered Compare and POP Twice 

Applicable processors: 80387. 80486 
Category: Comparison mstaiction 


Status affected: CO. C2, C3, DE, IE 


Coding example: 

FUCOMPP ;compare ST and ST(1) 

Description: fucompp compares the specified source with the top stack element 
(ST). If no operand is specified, fucompp compares ST and ST(1). This instruction 
differs from FC9M in that fucompp does not cause an invalid operation exception if 
one of the operands is a NaN. Condition codes are affected accordingly The stack 
is then popped twice. 


FWAIT: CPU Wait 

Applicable processors: HOST, S0287. 80387, 80486 
Category': Flag- and processor-control instructions 
Status affected: None 
Coding example: 

FWAIT 

Description: FWAIT is effectively the same as the WAIT command This instruction 
enables the synchronization of the microprocessor and the NPX.'FPU. FWAIT causes 
the microprocessor to suspend operation until it receives a signal indicacine that the 
NPX/FPU has completed the last operation. 



FXAM. Examine 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Comparison instruction 
Status affected: CO. Cl, C2. C3 
Coding example: 

FXAM 
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Description: fxam examines the top stack element (ST) 
condition codes) the condition, or attributes, of the value. 


and repons (in the 


FXCH: Exchange Registers 

Applicable processors: 8087. 80287, 80387, 80486 

Category: Data-transfer instruction 

Status affected: IE 

Coding examples: 

FXCH ST(3) 

FXCH TEMP 

Description: FXCH switches the value of the top stack clement (ST) with the value 
of the operand. 


EXTRACT: Extract Exponent and Significand 

Applicable processors: 8087, 80287, 80387 80486 
Category: Arithmetic instruction 
Status affected: IE 
Coding example: 

FXTRACT 

Description: fxtract removes the top suck element (ST) and converts it to two 
numbers: the exponent and significand of the original number. The exponent is 
pushed on the stack, followed by the significand, which results in ST=significand 
and ST(l)=cxponent. 



FYL2X: Y*log 2 X 

Applicable processors: 8087. 80287, 80387, 80486 
Category: 1 ranscendcntal instruction 
Status affected: Pn 
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Coding example: 

FYL2X 

Description: fyl2X calculates 7.=Y*LOG,X. where X is the top stack element (ST), 
and Y is the second stack element (ST( 1))' Both stack elements arc popped, and the 
result (2) is pushed on the stack and becomes the new ST. This instruction performs 
no validation checking of the input value. The program ensures that 0<X<«* and 


FYL2XP1: Y*log 2 (X+l) 

Applicable processors: 8087, 80287, 80387, 80486 
Category: Transcendental instruction 
Status affected: PE 
Coding example: 

FYL2XP1 

Description: fylexpi calculates 2«Y» LOG,(X-1), where X is the top stack element 
(ST), and Y is the second stack element (ST(I)). Both stack elements arc popped, and 
the result (Zj is pushed on the stack and becomes the new ST. This instruction 
performs no validation checking of the input value. The program ensures that 
0< jXj <(l-(V2/2)) and-~<Y<+-. 


HLT: Halt 

Applicable processors: 8066/8088, 80286, 80386, 80486 
Category: Flag- and processor-control Instructions 
Flags affected: None 
Coding example: 

HLT 

Description: hlt causes the microprocessor to stop execution and leaves the CS:IP 
registers pointing to the instruction following the HLT. This halt condition B 
terminated only after the system receives an interrupt or after the RESET line B 
activated. 
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1DIV: Integer Divide 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic Instructions 

Flags affected: AF (undefined), CF (undefined), OF (undefined), PF (undefined), 
SF (undefined), ZF (undefined) 

Coding examples: 


IDIV 

BX 

;AX-DX:AX/BX 

IDIV 

W0RD_TEMP 

;AX-DX:AX/W0RD_TEMP 

IDIV 

BYTE_SUM 

;AL-AX/BYTE_SUM 

IDIV 

DW0RD_SUM 

;EAX-EDX:EAX/DW0R0_$UM 

IDIV 

W0RD_TBL(BX) 

;Indirect address example 


Description: If the operand is a byte value, IDIV divides the contents of AX by the 
contents of the operand and stores the result in AL and the remainder in AH. If the 
operand is a word value, IDIV divides the contents of DX:AX by the contents of the 
operand and stores the result in AX and the remainder in DX. 

On the 80386 and 80486, if the operand is a doubleword value, IDIV divides 
the contents of EDX:EAX by the contents of the operand, and stores the result in EAX 
and the remainder in EDX. 

This instruction treats numbers as signed binary values. 



IMUL: Integer Multiply 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Arithmetic instructions 

Flags affected: AF (undefined), CF, OF, PF (undefined), SF (undefined), 
ZF (undefined) 


Coding examples: 


IMUL 

BX 

;DX:AX-AX*BX 

IMUL 

W0RD_TEMP 

;DXlAX-AX*W0RD_TEMP 

IMUL 

BYTE.SUM 

;AX-AL*BYTE_SUM 

IMUL 

W0RD_TBLIBX1 

;Indirect address example 

IMUL 

ECX,DW0RD_TEMP,10 

;ECX"DW0RD_TEMP*1 i 
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Description: The results of this operation depend on the number of operands 
specified. Processors other than the 80385 and 80486 require exactly one operand 
for this instruction. 

If only one operand is given, it is multiplied by AI.. AX, or EAX. If the operand 
is a byte value, IMUL multiplies the contents of AJ. by the contents of the operand and 
stores the result in AX, If the operand is a word value, IMUL multiplies the contents 
of AX by the contents of the operand and stores the result in DX:AX. 

If two operands are given, IMUL multiplies the first operand by the second one 
and stores the result in the first operand. Doth operands must be of equal size. 

If three operands are given and the third operand is an immediate value, IMUL 
multiplies the second operand by the third one and stores the result in the first 
operand. 

This instruction treats numbers as signed binary values. 


IN: Input from Port 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Data-transfer instructions 
Flags afifccted: None 
Coding examples: 

IN AL, 64 h 

IN AX,OX 

IN .EAX,OX 

Description: IN loads a byte, word, or doubleword to AL AX or fay . i 

^rif h d SPCC ' f,ed hardware 1/0 port addrcss * A P°n number less than 25^ii7be 
specified as a constant or as a variable in the DX register A oon numhT u 

25 V however. be specified in the DX register ^ number greater than 


INC: Inc ivment 

Applicable prvcessorv vm-WH. 802S6, 80J86. 80486 
Category: Anihnictu instructions 
Flags affected: AF, OF, PF, SF. ZF 
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Coding examples: 

INC 

AX 

INC 

* SUM 

INC 

CL 

INC 

EDI 

INC 

TEMPI SI1 


Description: INC changes, by increments of 1, the contents of the operand. The 
operand is assumed to be an unsigned binary value. 



INS: Input String from Port 

Applicable processors: 80286, 80386, 80486 


Category: Data-transfer instructions 
Flags afTccted: None 
Coding examples: 


INS 

CX.DX 

;load word 

INS 

BL.DX 

;load byte 

INS 

EAX.0X 

;Load doubleword 


Description: INS loads a byte, word, or doubleword from the specified hardware 
I/O port address (indicated by the value in DX) to the destination operand. The size 
of the destination operand determines whether a byte, word, or doubleword is 
transferred. If the destination operand is an offset address, that address is relative to 
the ES register. No segment override is possible. 


INSB: Input String Byte from Port 

Applicable processors: 80286, 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

INSB 

Description: Upon receiving a byte from the hardware 1 'O port address specified in 
DX, INSB loads that byte to the address specified by ES:|D1). The port number can 
range from 0 to 65.535. After the transfer, D1 changes in an increment or decrement 
of 1, depending on the setting of the direction flag. 
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INSD: Input String Doubleword from Port 

Applicable processors: 80386, 80486 
Category: Data-transfcr instructions 
Flags affected: None 
Coding example: 

INSD 

# 

Description: INSD loads a doubleword from the hardware I/O port address specified 
in £)X to the address specified by ES:|EDIJ. After the transfer, EDI changes in 
increments or decrements of four, depending on the setting of the direction flag. 


INSW: Input String Word from Port 

Applicable processors: 80286, 80386, 80486 
Category: Data*transfer instructions 
Flags affected: None 
Coding example: 

2 NSW 

Description: insw loads a word from the hardware I'O port address specified In 

DX to the address specified by ES:[t)lJ. The port number can range from 0 to 65,535. 

After the transfer, DI changes in increments or decrements of two, dependintt on the 
setting of the direction flag. <.pcna»ngontnc 


INT: Software Interrupt 


Applicable processors: 8086/8088, 80286,80386, 80486 
Category: Controhtransfer instructions 
Flags affected: IF, TF 
Coding examples: 


INT 16h 

INT I3h 
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Description: INT initiates a software interrupt of the CPU, and starts the following 
functions: 

□ Pushing the flags on the stack 
Q Clearing the TF and IF flags 

O Pushing the value of C3 on the stack 

□ Loading CS with the segment address of the Interrupt being Invoked (this 
segment address is found at the calculated address In the interrupt vector 
table) 

□ Pushing the value of IP on the stack 

□ Loading IP with the offset address of the interrupt being invoked (this offset 
address is found at the calculated address in the interrupt vector table) 

Execution then continues at the newly loaded CS:IP address until an I RET 
instruction is encountered. 


INTO: Interrupt on Overflow 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

INTO 

Description: If the overflow flag (OF) Is set, into executes an interrupt 4 and con* 
trol proceeds as though an INT 4 had been issued. Be aware that, in this case, the flags 
register is affected as described for the INT instruction. 


INVD: Invalidate Data Cache 

Applicable processors: 80486 
Category: Processor-control instructions 
Flags affected: None 
Coding example: 

INVD 
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Description: This instruction causes the information in the on-chip cache to be 
flushed. It also causes a special-function bus cycle to be issued, which can be used 
as an indicator to external caches (those on the 80486) to flush as well. 


INVLPG: Invalidate TLB Entry If Present 

Applicable processors: 80486 
Category: Processor-control instructions 
Flags affected: None 
Coding example: 

INVLPG TLB_L0C 

Description: This instruction is used to invalidate an entry in the cache used for 
table entries (the TLB). If the address of the operand is a valid entry in the TLB (one 
that has not previously been invalidated), it is marked as invalid. 


IRET: Return from Interrupt 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 

Flags affected: AC, AF, CF, DF, IF, lOPL, NT, OF, PF, RF, SF, TF, VM, ZF 
Coding example: 

IRET 

Description: IRET terminates an interrupt procedure and, by popping the values 

of IP, CS, and the flags register from the stack, rerums control to the point at which 
the interrupt occurred. 


JA: Jump If Above 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
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Coding example: 

JA NEXTSTEP 

Description: JA causes program execution to branch to the operand address if 
the carry and zero flags are both clear. This instruction is functionally the same as 
JNBE. 


JAE: Jump If Above or Equal 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category*. Control-transfer instructions 
Flags affected: None 
Coding example: 

JAE NEXTSTEP 

Description: JAE causes program execution to branch to the operand address if 
the carry flag is clear. This instruction is functionally the same as JNB or JNC. 


JB: Jump If Below 

Applicable processors: 8086/8088,80286,80386,80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JB NEXTSTEP 

Description: JB causes program execution to branch to the operand address if 
the carry flag is set. This instruction is functionally the same as JC or jnae. 


JBE: Jump If Below or Equal 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer Instructions 
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Flags affected: None 
Coding example: 

JBE NEXTSTEP 

Description: JBE causes program execution to branch to the operand address If 
either the carry or zero flag Is set. This instruction is functionally the same as jna. 


■ ■ MM—>1 >»>..)I L 'MlllUl 

JC: Jump on Carry 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JC NEXTSTEP 

Description: JC causes program execution to branch to the operand address if 
the carry flag is set. This instruction is functionally the same as JB or jnae. 


JCXZ: Jump IfCX=0 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JCXZ SKIPJ.00P 

Description: JCXZ causes program execution to branch to the operand address If 
the value :.f CX is 0. 


JE: Jump If Equal 

Applicable processors: 8086/8088, 80286. 80386. 80486 
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Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JE NEXTSTEP 

Description: JE causes program execution to branch to the operand address If 
the zero flag is set. This Instruction Is functionally the same as JZ. 


JECXZ: Jump If ECX=0 

Applicable processors: 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JECXZ 8KXP_L00P 

Description: JECXZ causes program execution to branch to the operand address If 
the value of ECX Is 0. Although functionally the same a* JCX? JECXZ works with the 
32-blt ECX register. 



JG: Jump If Greater 

Applicable processors: 8086/8088. 80286, 80386. 80486 
Category: Control-transfer Instructions 
Flags affected: None 
Coding example: 


JO NEXT.8TEP 

rwrfntlon: JO causes program execution to branch to the operand address If 
flag equals the overflow flag or If the zero flag is clear. This instruction is 

functionally the same as JNLE. 
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JG1:: Jump If Greater or Equal 

Applicable processors: 8086.8088. 80286. 80.386. 80-186 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JGE NEXT_STEP 

Description: JGE causes program execution to branch to the operand address If 
the sign flag equals the overflow Hag. 1 his instruction is functionally the same as jnl. 

JL: Jump If Less 

Applicable processors: 8086 '80S8, 80286. 80386, 80486 
Category: Contrc'-rransfcr instructions 
Flags affected: None 
Coding example: 

JL NEXTSTEP 

Description: jl causes program execution to branch to the operand address if 

the s:gn flag does not equal the overflow flag. This instruction is functional the 
sameasJNGE. 1^4 


JLE: Jump If Less or Equal 

Applicable processors: 8086/8088. 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 


JLE 


NEXTSTEP 


Description: JLE causes program execution to branch to the operand address if 

e sign ag ocs not equal the overflow flag or if the zero flag is set. This instruction 
is functionally the same as jng. 
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JMP: Jump 


Applicable processors: 8086 8088, 80286. 80386, 80486 

Category: Control-transfer instructions 


Flags affected: None 
Coding examples: 


JMP EXIT_C0DE 

JMP (BX) 

JMP AX 


;Jump to address at |BX) 
;Jump to address in ax 


Description: JMP initiates program execution at the designated operand address, 
aflecting the CS and IP registers as necessary* to cause this unconditional branch. 


JNA: Jump If Not Above 

Applicable processors: 8086/8088. 80286. 80386. 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNA NEXTSTEP 

Description: JNA causes program execution to branch to the operand address if 
either the carry or zero flag is set. This instruction is functionally the same as JBE. 


JNAE: Jump If Not Above or Equal 

Applicable processors: 8086,-8088. 80286, 80386. 80486 
Category': Control-transfer instructions 


Flags affected: None 


Coding example: 

JN AE NEXTSTEP 

Description: JNAE causes program execution to branch to the operand address if 
the carry flag is*et. This instruction is functionally the same as JB or JC 
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JNB: Jump If Not Below 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 

« 

Coding example: 

JNB NEXTSTEP 

Descriotion: JNB causes program execution to branch to the operand address if 
the carry flag is clear. This instruction is functionally the same as JAE or JNC. 

JNBE: Jump If Not Below or Equal 

Applicable processors: 8086/8088.,30286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNBE NEXTSTEP 

Description: JNBE causes program execution to branch to the operand address if 
both the carry and aero flags arc clear. This instruction is functionally the same as ja. 

JNC: Jump on No Carry 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNC NEXTSTEP 

Description: JNC causes program execution to branch to the operand address if 
the carry flag is clear. This instruction Is functionally the same as JAE or JNB. 
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JNE: Jump If Not Equal 

Applicable processors: 8086 8088. 80286 80586. 80 *86 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNE NEXTSTEP 

Description: JNE causes program execution to branch to the operand address if 
the zero flag is clear. This instruction is functionally the same as jnz 


JNG: Jump If Not Greater 

Applicable processors: 8086/8068,80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNQ NEXTSTEP 

Description: JNQ causes program execution to branch to the operand address if 
the sign flag docs not equal the overflow flag or if the zero flag is set. This instruction 
is functionally the same as JLE. 


JNGE: Jump If Not Greater or Equal 

Applicable p rocessors: 8086/8088,80286,80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JNGE nex.t_stef 

Description: JNGE causes program execution to branch to the operand address if 
the sign (lag does not equal the overflow flag. This instruction is functionally the 
same as jl. 


Scanned by CamScanner 


818 


Part IN': Kcfcreiice 


JNL: Jump If Not Less 

Applicable processors: 8086 8088. 80286 80386. 80-186 
Category: Control-transfei instructions 
Flags affected: None 
Coding example: 

JNL NEXT_STtF 

Description: jnl causes program execution to branch to the operand address if 
the sign flag equals the overflow flag. This instruction is functionally the same as J6E. 


JNLE: Jump If Not Less or Equal 

Applicable processors: 8086 80S8. 80286. 80386. 80*86 
Category': Control-trausler instructions 
Flags affected: None 
Coding example: 

JNLE NEXT STEP 


Description: jnle causes program execution to branch to the operand address if 

the sign nag equals the overflow nag or the aero Hag is clear. This instruction is 
functionally the same as JG. 


JNO: Jump on No Overflow 

Applicable processors: 8086/8088, 80286, 80386. 80486 
Category: Control-transfer instructions 
Flags affected: None 


Coding example: 

JNO NEXT_STEP 

Description: jno causes program execution to branch to the operand address if 
the overflow flag is clear. 
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JNP: Jump on No Parity 

Applicable processors: 8086 H08K 80286. 80580. HO 1 H 6 
Category - Control-transfer instructions 

Flags affected: None 
Coding example: 

JNP NEXT_STEP 

Description: JNP causes program execution to branch to the operand address if 
the parin' flag is dear. This instruction is functionally the same as jpo. 


JNS: Jump on Not Sign 

Applicable processors: 8086/8088, 80286. 80386, 80186 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JN8 NEXTSTEP 

Description: jns causes program execution to branch to the operand address if 
the sign flag is clear. 


JNZ: Jump on Not Zero 

Applicable processors: 8086/8088. 80286, 80386, 80186 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 


JNZ NEXTSTEP 

Description: JNZ causes program execution to branch to the operand address if 
the zero nag is clear This Instruction is functional!)- ihe same as JN£. 
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JO: Jump on Overflow 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category': Control-transfer instructions 
Flags affected: None 
Coding example: 

JO NEXT_STEP 

Description: JO causes program execution to branch to the operand address if 
the overflow flag is set. 


' VI# 4. */f ... . . I* 


JP: Jump on Parity 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JP NEXTSTEP 

Description: JP causes program execution to branch to the operand address if 
the parity flag is set. This instruction is functionally the same as JPE. 

> 

JPE: Jump on Parity Even 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category': Control-transfer instructions 
I lags affected: None 
Coding example: 

JPE NEXTSTEP 

Description: JPE causes program execution to branch to the operand address if 
the parity flag is set. This instruction is functionally the same as JP. 
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JPO: Jump on Parity Odd 


Applicable processors: 8086/8088. 80286, 80386. 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JPO NEXT_STEP 

Description: JPO causes program execution to branch to the operand address if 
the parity flag is clear. This instruction is functionally the same as jnp 


JS: Jump on Sign 

Applicable processors: 8086/8088, 80286. 80386. 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JS NEXTSTEP 

Description: JS causes program execution to branch to the operand address If 
the sign flag is set. 


JZ: Jump on Zero 

Applicable processors: 8086/B088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

JZ NEXTSTEP 

Description: JZ causes program execution to branch to the operand address if 
the aero flag is set This instruction is functionally the same as JE. 
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LAHF: Load AM Register with I :, .ags 

Applicable processors: 8086 8088. 80286. 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

LAHF 

Description: LAHF copies the low-order byte of the flags register to AH. After 
execution of this instruction, bits 7. 6. 4. 2. and 1 of AH are equal to SF. ZF. AF, PF, 
and CF. respectively. 1 


LAR: Load Access-Rights Byte 

Applicable processors: 80286, 80386. 80486 
Category: Data-transfer instructions 
Flags affected: ZF 
Coding example: 

LAR AX,SELECT 

Description: Based on the selection in the second operand, the high byte of the 
destination register is overwritten by the value of the access-rights byte, and tlir low 
byre is zeroed. The loading is done only if the descriptor is visible at the cut rent 
privilege level and at the selector RPL. The zero flag is set if the loading operation is 
successful. 



LDS: Load DS Register 


Applicable processors: 8086/8088. 80286. 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

LDS SI,SOURCE^BUFFER 
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Description: IDS performs two distinct operations, it loads 1)S with the segment 
address ot the source operand and loads the destination operand with the olisci 
address of the source operand. 

LEA: Load Effective Address 

Applicable processors: 80868088. 80286. 80586. 80-486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

LEA AX,MESSAGEJ 

Description: LEA transfers the offset address of the source operand to the destina- 
tion operand. The destination operand must be a general word register. 

• * - a 

LEAVE: High-Level Procedure Exit 

Applicable processors: 80286,80386.80486 
Category: Flag- and processor-control instructions 
Flags affected: None 
Coding examples 
LEAVE 

Description: LEAVE undoes the changes performed by the enter instruction. This 
Instruction is used for exiting high-level-language subroutines. 


LES: Load ES Register 

Applicable processors: 8086*088,80286.80386. 80486 
Category: Data-transfer Instructions 
Flags affected: None 
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Coding example: 

LES DI,OEST_BUFFER 

Description: LES performs two distinct operations: it loads ES with the segment 

address of the source operand and loads the destination operand with the offset 

address of the source operand. ' 


LFS: Load FS Register 

Applicable processors: 80386. 80486 
Category: Data*transfer instructions 
Flags affected: None 
Coding example: 


LFS 


DI,DE$T_BUFFER 


Description: LFS performs two dis.ir.ci operations: it loads FS with the - 


LGDT: Load GDT Register 

Applicable processors: 80286, 80386.80486 
Category: Data-transfer instructions 
Flags affected: None 


Coding example: 
LOOT TEMPfBX] 


(CDT^froimhtXm.OTaddr^Jj 1 ** ‘f*l g ‘ ob » l dc,e '‘P«»table 
in protected.mode operating system software: it is not usetHn ap^tatianrooftwanr 



LGS: Load GS Register 

Applicable processors: 80386. 80486 
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Category: Data-transfer instructions • 

Flags affected: None 
Coding example: 

IGS 01,DEST_BUFFER 

Description: <LGS performs wo distinct operations; it loads GS with the segment 
address of the source operand and then loads the destination operand with the offset 
address of the source operand. 

LIDT: Load IDT Register 

Applicable processors: 80286. 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
(Coding example: 

• • 

LIDT TEUP(BX) 

Description: LIDT loads the six bytes associated with the interrupt descriptoi table 
(IDT) from the memory address specified in the operand. This instruction is for use 
in protccied-mode operating system software; it is not used in applications software. 



LLDT: Load LDT Register 

Applicable processors: 80286,80386,80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

LU)T AX 

* 

Description: Based on the selector specified in the operand, llot transfers the valid 
global descriptor table entry to the local descriptor table (LDT). This instruction is 
used in protected-mode operating system software but not used in applications 
software. 
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LMSW: Load Machine Status Word 

Applicable processors: 80286, 80386, 80486 
Category: Data-transfer instructions 

i 

Flags affected; None 
Coding example: 

LMSW AX • 

Description: lmsw copies the value of the operand to the machine status word. This 
instruction is for use in operating system software only, not in applications software. 


LOCK: Lock Bus 

Applicable processors: 8086/8088, 80286. 80386, 80486 
Category: Flag- and processor-control instructions 
Flags affected: None 
Coding example: 

LOCK XLAT 

Description: LOCK prohibits Interference from any other coprocessors during the 
execution of the next instruction issued. LOCK is a prefix to be used with other 
operations. 


LODSB: Load a Byte from String into AL 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: String-manipulation instructions 
Flags affected: None 
Coding example: 

L00SB 

Description: LODSB loads AL with the contents of the address pointed to by SI. SI 
then changes in increments or decrements of 1, depending on the setting of the 
direction flag. Intel lists this command as L0DS; however, the assembler distinguishes 
between byte (LODSB) and word (L00SW). 
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LODSD: Load a Doubleword from String into EAX 

Applicable processors: 80386, 80486 
Category: String-manipulation instructions 
Flags affected: None 
. Coding example: 

LOOSO 

Description: LOOSO loads EAX with the contents of the address pointed to by ESI. ESI 
then changes in increments or decrements of four, depending on the setting of the 
direction flag. 


LODSW: Load a Word from String into AX 

Applicable processors: 8086/8088, 80286,80386,80486 
Category: String-manipulation instructions 
Flags affected: None 
Codiag example: 

LOOS* 

i • 

Description: L00S* loads AX with the contents of the address pointed to by SI. SI 
then changes in increments or decrements of two, depending on the setting of the 
direction flag. Intel lists this command as LOOS; however, the assembler distinguishes 
between byte (L00S0) and word (loosw). 



LOOP: Loop 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Cat eg o ry: Control-transfer instructions 
Flags affected: None 
Coding example: 

LOOS POINT J.00P 
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Description: This instruction causes program execution to branch to the address 
of the destination operand, based on the contents of GX. if CX does not equal 0, 
CX changes in decrements of 1. and the branch occurs. If CX is 0. no decrements or 
branching occurs, and execution proceeds to the next instruction. 

LOOPE: Loop While Equal 

Applicable processors: 80868088. 80286. 80386. 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

L00PE TEST_L00P 

Description: based on the contents of CX and the zero flag, program execution 
branches to the address of the destination operand. If CX does not equal 0 and the 
zero flag is set.CX changes in decrements of 1, and the branch occurs. If CX is 0 or 
the zero flag is clear, no decrements or branching occurs, and execution proceeds 
to the next instruction. This instruction is functionally equivalent to L00PZ. 



LOOPNE: Loop While Not Equal 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

L00PNE TESTJ.00P 

Description: Based on the contents of CX and the zero flag, program execution 
branches to the address of the destination operand. If CX docs not equal 0 and 
the zero flag is clear. CX changes in decrements of 1, and the branch occurs. If CX 
is 0 or the zero flag is set, no decrements or branching occurs, and execution 
proceeds to the next instruction. This instruction is ftinctionally equivalent to 
L00PNZ. 
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LOOPNZ: Loop While Not Zero 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

L00PNZ TEST_100P 

Descriptldn: Based on the contents of CX and the zero flag, program execution 
branches to the address of the destination operand. If CX does not equal 0 and the 
zero flag is clear, CX changes in decrements of 1, and the branch occurs. If CX is 0 
or the zero flag is set. no decrements or branching occurs, and execution proceeds 
to the next instruction. This instruction is functionally equivalent to L00PNE. 

LOOPZ: Loop While Zero 

Applicable processors: 8086/8088, 80286, 80386,80486 
Category: Control-transfer instructions 
Flags affected: None 
Coding example: 

L00PZ TEST.LOOP 

Description: Based on the contents of CX and the zero flag, program execution 
branches to the address of the destination operand. If CX does not equal 0 and the 
zero flag is set, CX changes in decrements of 1. and the branch occurs. If CX Is 0 or 
the zero flag is dear, no decrements or branching occur, and execution proceeds to 
the next instruction. This Instruction is functionally equivalent to LOOPS 



LSL: Load Segment Limit 

Applicable processors: 80286. 80J86, 80486 
Category: Data-transfer instructions 
Flags affected: ZF 
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Coding example: 

LSL AX,SELECTOR 

Description: Based on the selector specified in the source operand, LSL loads the 
descriptor's limit field into the target operand (register). The descriptor denoted 
by the selector must be visible. If the loading is successful, the zero flag is set; 
otherwise, it is cleared. 


LSS: Load SS Register 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

LSS DI.DEST_BUFFER 

Description: LSS performs two distinct operations: it loads SS with the segment 
address of the source operand and then loads the destination operand with the oflset 
address of the source operand. 


LTR: Load Task Register 

Applicable processors: 80286, 80386,80486 

Category: Data-transfer instructions 

Flags affected: None 

Coding examples: 

LTR DX 

LTR TEMPIBX J 

Description: LTR loads the task register from the value of the source operand. This 
instruction is for use in operating system software only and is not used in applies* 
tions software. 
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MOV: Move 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Data-transfcr instructions 
Flags affected: None 
Coding examples: 


MOV 

AX.BX 

;ax=bx 

MOV 

EAX,TEMP 

;EAX«TEMP (doubleword) 

MOV 

SUM,BX 

;SUM-BX (SUM is a word) 

MOV 

CL, 57 

;CL-57 

MOV 

DECIMAL,10 

;DECIMAL"1# 

MOV 

AX,TEMP[BX] 

{Indirect address example 


Description: MOV copies the contents of the source operand to the destination 
operand. When the source operand is not an immediate value, both operands must 
be of equal length. If the source or destination operand is a doubleword register, the 
other register can be a special register, such as CR0, CR2, CR3, DR0, DR1, DR2, DR3, 
DR6, DR7.TR6, orTR7. 


MOVSB: Move String, Byte-by-Byte 

Applicable processors: 8086/8088,80286, 80386, 80486 
Category: String-manipulation instructions 
Flags affected: None 
Coding examples: 

MOVSB 

REP MOVSB ;Repeat a move loop 

Description: MOVSB moves strings, byte-by-byte. The values of SI and DI change in 
increments or decrements of 1, depending on the setting of the direction flag. 
Usually this instruction is used with the REP instruction to repeat the move for a 
maximum of CX bytes. Intel lists this command as M0VS; however, the assembler 

makes the byte/word distinctions. 
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MOVSD: Move String, Double word-by-Doubleword 

Applicable processors: 80386, 80486 
Category: String-manipulation Instructions 
Flags affected: None 
Coding examples! 

MOVSD 

REP MOVSD ;Rspsst • move loop 

Description: MOVSD moves strings, doubleword-by-doubleword. The values of ESI 
and EDI change in increments or decrements of four, depending on the setting of 
the direction flag. Usually, this instruction is used with the REP instruction to repeat 
the move for a maximum of ECX words. 


MOVSW: Move String, Word-by-Word 

Applicable processors: 8086/8088, 80286, 80386,80486 
Category: String-manipulation instructions 
Flags affected: None 
Coding examples: 

MOVSW • 

REP MOVSW ;Repeat a movt loop 

Description: movsw moves strings, word-by-word. The values of SI and DI change 
in Increments or decrements of two, depending on the setting of the direction 
flag. Usually, this instruction is used with the REP instruction to repeat the move for 
a maximum number of CX words. Intel lists this command as M0VS; however, the 
assembler makes the byte/word distinctions. 



MOVSX: Move with Sign Extended 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
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Coding examples: 

MOVSX CAX.OX ;EAX« BX 

MOVSX EAX.TEMP ;EAX-TEMP (TEMP is a word) 

MOVSX CX.Al ;CX«AL 

Description: movsx moves the source operand to the destination operand and 
extends the high-order bit to the balance of the bits in the destination operand I he 
source operand must be smaller than the destination operand. 


MOVZX: Move with Zero Extended 

Applicable processors; 80386, 80486 


Category: Data-transfer instructions 
Flags affected: None 
Coding examples: 


MOVZX EAX.BX ;EAX«BX 

MOVZX EAX.TEMP ;EAX«TEMP (TEMP is a word) 
MOVZX CX.AL *,CX=AL 


Description: MOVZX moves the source operand to the destination operand and 
cleats the remaining bits in the dest.nation operand The source operand must b 
smaller than the destination operand. 





MUL: Multiply 

Applicable processors: 8086/8088, 80286, 80386, 80486 


Category: Arithmetic instructions 

Flags affected: AF (undefined). CF. OF. PF (undefined), 
ZF (undefined) 

Coding examples: 


MUL 

BX 

MUL 

ECX 

MUL 

W0RD_TEMP 

MUL 

BYTE_SUM 

MUL 

W0RD_TBLIBX1 


;0X:AX=AX*BX 
;EDX:EAX=EAX*ECX 
;DX:AX=AX*W0RD_TEMP 
;AX=AL*BYTE_E'JM 

;indirect address example 


SF (undefined). 
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inscription- II the operand is a byte value, MUL multiplies the contents ofALhy 
the contents of the operand and stores the result in AX. If the operand is a word value, 
mul multiplies the contents of AX by the contents of the operand and stores the re- 
Milt in DX-AX. If the operand is a doubleword value. MUL multiplies the contents of 
PAX by the contents of the operand and stores the result in EDXEAX This 
instruction treats numbers as unsigned binary values. 



NEG: Negate 

Applicable processors: 8086 '8088, 80286, 80386. 80486 

Category: Arithmetic instructions 

Flags affected: AF, CF, OF. PF, SF, ZF 

Coding examples: 

\EG TEMP 

NEC CL 

ILb EAX 

Inscription: NEG calculates the mo's complement of the destination operand and 
st ires the result in the destination operand This calculation is effectively the same 
.us subtracting the destination operand from zero. 



NOP: No Operation 

Applicable processors: S086/8088, 80286, 80386. 80486 
Category: I lag- and processor-control instructions 
Flags affected: None 
Coding example: 

NOP 

Description nop simply takes space and time. It causes the CPU to do nothing. The 
instruction is used primarily when patching executable files, to block out instruc¬ 
tions already in place. 
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NOT. Logical NO!' 

Applicable processors: 80S6,8088. 80286, 80386, 80486 
Category: Bit-manipulation instructions 
Flags affected: None 
Coding examples: 


NOT 

CL 


NOT 

BYTE_SUM 

;Use byte value 

NOT 

W0RD_SUM 

;Use word value 

NOT 

DW0RD_SUM 

;Use doubleword value 

NOT 

AX 


NOT 

EBX 



Description: NOT inverts the bits in the destination operand (0 becomes 1, and 
1 becomes 0) and stores the inverted bits in the destination operand. 


tag jouct — 

OR: Logical OR 

Applicable processors: 80868088, 80286, 80386, 80486 

Category: Bit-manipulation instructions 

Flags affected: AF (undefined), CF, OF, PF, SF, ZF 

Coding examples: 


OR 

AL.BL 

OR 

AL,10000000b 

OR 

EAX,0FFFFh 

OR 

OX,TEMP 

OR 

AX.CX 


Description: OR performs a logical OR ol the operands and stores the result in the 
destination operand. Each bit of the resultant byte or word is set to 1 if either or both 
of the corresponding bits of each operand are set to 1. 


OUT: Output to Port 

Applicable processors: 8086,8088. 80286. 8<b8o. P0 k-,C 
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Category: Data-transfer instructions 

Hags affected: None 

Coding examples: 

OUT "^'T- 64h,AL 
OUT DX,AX 

OUT OX,EAX 

Description: OUT sends a byre (AL), word (AX), or doubleword (EAX) to the 
specified hardware 1 O port address. A port number lower than 256 may be specified 
as a constant or as a variable in the DX register. A port number higher than 255, 
however, must be specified in the DX register. 


OUTS: Output String to Port 

Applicable pi’Dcessors: 80286. 80386, 80486 

Category: Data- transfer instructions 

Flags affected: None 

Coding examples: 

OUTS DX, C.X ;0.'Jtput word 

OUTS DX.BL ;0u tput byte 

ascription: OUTS sends a ,bytc or a word (length is specified by the size of the source 

Dv -and) to the hardware- I/O port address specified in DX. The port number can 

opcI * # omO to 65.535. 
range h- 


OUTSB: Output Strin 8 B > te to Port 

Applicable process: ^6. *0386. 80486 
Category: Data-transfer instre ,UKV1S 
Flags affected: None 
Coding example: 


OUTSB 
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l'; v ription: OUTSB sends a byte from the address specified by DS |SI] to the 
hardware I/O port address specified in DX. The port number can range from 0 to 
65,535. After the transfer, D1 changes in an increment or decrement of 1, depend¬ 
ing on the setting of the direction flag. 


OUTSD: Output String Doubleword to Port 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

0UTS0 

Description: OUTSD sends a word from the address specified by DS:[ES1] to the 
hardware I/O port address specified in DX. After thr transfer, D1 changes i<« 
increments or decrements of four, depending on the netting of the direction flag. 


OUTSW: Output String Word to Port 

Applicable processors: 80286, 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

OUTSW 

Description: OUTSW sends a word from the address specified by DS:(SI] to the 
hardware I/O port address specified in DX. The port number can range from 0 to 
65,535. After the transfer, DI changes in increments or decrements of tw o. depend¬ 
ing on the setting of the direction flag. 


POP: Remove Data from Stack 

Applicable processors: 8086/8088. 80286. 80386. 80486 
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Category: Data-transfer instructions 
Flags affected: None 
Coding examples: 


POP 

AX 

POP 

DS 

POP 

8S 

POP 

HOLD REG 


Description: POP removes from the stack a word or a doubleword (depending on 
the size of the operand) and places that word or doubleword in the desired 
destination operand. 


POPA: POP All General Registers 

Applicable processors: 80286, 80386, 80*86 
Category: Data-transfer 'ructions 


Flags affected: None 
Coding example: 
POPA 


D c ^ v BVs e P 8 BXDx p ^r:v T x r and ,oads • hem 

i, is popped • • BX - DX '° C ** The SP re S.5.cr is discarded when 



POPAD: POP Ail General Doubleword Registers 

Applicable processors: 8038 6 , 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

POPAD 


Description: POPAD removes and loads the e 
Slack in dm order: EDI. ESI. EBP. ESP. EBX E 
discarded when it is popped. 


■^'purpose registers from the 
f-W. Tnc FSI* register i: 
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i'OPF: Remove I ; lags from Stack 

Applicable processors: 8086/8088, 80286. 80386, 80486 
Category: l)ata-transfcr instructions 

Flaps affected: AC, AF. CF. 1)F. IF, 101*1.. NT. OF. PI*. SF, TF. ZF 
Coding example: 

P0PF 

Description: P0PF removes a word from the stack and places the word in the Haps 
register. 


POPFl): Remove Extended l : lags Irom Stack 

Applicable processors: 80386, 80486 


Category: l)ata-transfer instructions 


Flags affected: AF. CF, DF, IF. 101*1.. NT. OF. I»F. SF. TF. ZF 


Coding example: 


POPFO 

Description: POPFO removes a doubleword from the stack and places that double- 
word in Inc extended flags register. 



PUSH: Place Data on Stack 

Applicable processors: 8086/8088, 80286, 80386, 80“i86 
Category: Data-transfer instructions 
Flags affected: None 
Coding examples: 


PUSH AX 

PUSH EBX 

PUSH OS 

PUSH H0LD_REG 

PUSH 50h 


;Will not work on 8066/6068 
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Part IV: Reference 


Description: push places a copy of the operand's value on the stack For the 8086< 
8088, only the values of registers (byte or word) can be pushed For all other 
microprocessors, immediate values also can be pushed 


PUSHA: Push All General Registers 

Applicable processors: 80286, 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

PUSHA 


Description: The general-purpose registers are pushed on the stack in this order: 
AX. CX. DX. BX. SP, BP, SI, DI. The SP value pushed is the value existing before this 
instruction is executed. 


v .ssasmssam 

PUSHAD: Push All General Doubleword Registers 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

PUSHAD 

Description: PUSHAD pushes the general-purpose doubleword registers on the 
stack in this order: EAX, ECX, EDX, EBX. ESP. EBP, ESI. EDI. The ESP value pushed 
is the value existing before this instruction is executed. 

PUSHF: Place Flags on Stack 

Applicable processors: 8 )86/8088. 80286, 80386, 80-486 
Category: Data-transfer instructions 
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Hags affected: \<me 
Coding example: 

PUSHF 

Description: PUShF places a copy of the Hags register on the stack 


PUSHFD: Place Extended Flags on Stack 

Applicable processors: 80386. 80486 
Category: Data-trnnsfer instructions 
Flags affected: None 
Coding example: 

PUSHFD 

Description: PUSHFD places a copy »l the extended Hags register on the stack. 


RCL: Rotate Left through Carry’ 

Applicable processors: 8086 8088. 80286. 80386. 80486 

Category’: Bit-manipulation instructions 

Flags affected: CF. OF 

Coding examples: 

RCL AX,1 

RCL BL,3 

RCL E0X.16 

RCL TEMP,CL 

Description: RCL rotates all bits in the destination operand to the left bv the nunv 
ber of places specified in the source operand. The rotation is performed through 
the earn flag in an order that rotates the most significant bit of the destination 
operand to the carry flag and rotates the carry flag to the least .significant bit of the 

destination operand. 
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NCR: Rotate Right through Cam 

Applicable processors: SOSO Siiss SnCSo 

Category-; bit-manipulation mscr.ictmivs 
Flags affected: CF. Ol 
Coding examples: 


E3',16 
T£M?,CL 


Description: RC« routes all bus the clcstmaltoo operand ,o ,, V neht ht ,„e 

*z n z:;r?r *■ tam n - - ::j: 

K.UH oil oi u.c destination onerantl • 


REP: Repeat 

•Applicable processors: 8086 8088. 80286 80386. 80-486 
Category: String-manipulation instructions 
Flags affected: None 
Coding example: 

RE? M0VS6 

Description: RE? causes string-manipulation in-sm.. f . 

ber ol iterations specified in C\ (if workine vuh h IO rc P ca tcd the nuni- 

'vorkint* with doubleword op^ancKp ' ^ "° r “ ° pe ™ d » - «X (if 



REPE: Repeat If Equal 


Applicable processors: »)«<, 8U88 . 80 > 86 . 8 „ <(j() 

Category: String-manipulation instructions 
Flags affected: None 
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Coding example: 

h£ 3 E C.VPSV. 

Description: P£=E cause', string-manipulation instructions to be repeated the 
number ot iterations specilied in LX (if working with b'le or word operands) or 
ht.\ tit working with doub eword operands) When used with CMPS3. CUPS’.'*. SCASB. 
or SCAS.v. this instruction re ’eats only while the zero flag is set. REPE is functionally 
equivalent to ?£?Z 


REPNE: Repeat If Not Equal 

Applicable processors 8086 8088. 8C286. 8038 b. 81)486 
Category: String-manipulation instructions 
Flags affected: None 
Coding example: 

REPNE CUPSV. 

Description: PE 5 ’." ca.i'es string-manipulation instructions to he repeated the 
number of iterations specified in CX (if working with byte or word operands) or 
ECX (if working with doubleword operands). When used with CMPS3. CMPSw. SCASB. 
or SCas//. this instruction repeats only while the zero flag is dear This instruction is 
functionally equivalent to REPNZ 


REPNZ: Repeat If Not Zero 

Applicable processors: 8086 8088. 80286. 80386. 8 O -186 
Category': String-manipulation instructions 
Flags affected: None 
Coding example: 

REPNZ CMPSW 

Description: repnz causes string-manipulation instructions to be repeated the 
number of iterations specified m CX (if working with byte or word operands) or ECX 
(if working with doubleword operands) When used with CUPSB. CMPSW. SCASB. or 
SCAS.v. this instruction repeats only w hile the zero flag is clear. REPNZ is functionally 
equivalent to REPNE. 
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REPZ: Repeat If Zero 

Applicable processors: 80S6 8088. 80286. 80386. 80*486 
Category': String-manipulation instructions 
Flags affected: None 


Codiagxsaxnple: 


REPZ CKPSW 




Description: REPZ causes string-manipulation instructions to be repeated the 
number of iterations specified in CX (if working with byte or word operands) or 
ECX (if working with doubleword operands). When used with CMPSB. CMPSW. SCASB. 
*>r scasw. this instruction repeats only while the zero flag is set. REPZ is functionally 
equivalent to REPE. 



RET: Return from Subroutine 

Applicable processors: 8086/8088. 80286. 80386. SO- 1 S 6 
Category: Control-transfer instructions 
Flags affected: None 
Coding examples: 

RET 

RET 2 / 

Description: By popping IP from the stack. RET transfers program control back to 
the point at which a CALL was issued. If the CALL was to a far procedure, both CS:IP 
are popped from the stack. 

If the RET has a specified return value (2, in the coding example), the stack is 
adjusted by that number of bytes. The coding example shows that a word is dis¬ 
carded from the stack after either IP or CS:IP is popped. 


ROL: Rotate Left 

Applicable processors: 8086/8088, 80286, 80386. 80486 
Category: Bit-manipulation instructions 
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Flag.s affected: CF. OF 

Coding examples: 

ROl Ax • ^ 

ROL BL ,3 

ROL ox.ie 


Description: ROL rotates all bits in the destination operand to the left b> the num 
ber of places specified in the source operand 


ROR: Rotate Right 

Applicable processors: 8086-8088. 80286:80586.80*86 

Category: Bit-manipulation instructions 

Flags affected: CF, OF 

Coding examples: 

ROR AX, 1 

ROR BL,3 

ROR OX, 1C 

ROR TEMP,CL 

Description: 808 rotates all bits in the destination operand to the right by the 

number of places specified in the source operand. __ 




SAHF: Store AH into Flags Register 

Applicable processors: 8086,8088, 80286. 80586. 80*86 
Category! Data-transfer instructions 
Flags affected: AF, CF, PF, SF, ZF 
Coding example: 

SAHF 

, the contents of AH to the low-order byte of the flags 

cTecuZ oil instruction. SF, .,F. AF. PF. and CF are cc.ua. to bits 

?, 6. 4. 2. and 1 of AH. respectively. 
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SAJ.: .Arithmetic Shift Left 


Applicable processors: 8080 8 i> 8 S. K028O. 80380. 80-rSO 


Category: Bit-manipulation instructions 


T *=~ 


Flags affected: AF (undefined for all processors through 80286, not affeaed 
begmnmg OF. PF. SF. ZF 

Coding examples: 


SAL 

SAL 



AX. 1 
6L,3 
OX,16 
TEMP,CL 



DestTfpTtonrSAt >hi*u» ail bus in the destination operand to the left bv the num¬ 
ber of plates specified in the source operand. High -order bits arc lost and low-order 
bits are cleared. 





SAR: Arithmetic Shift Right 


Applicable processors: 8086 8088. 80286 . 80386. 8 O -186 
Category: Bit-manipulation instructions 

Flags affected: AF (undefined for all processors through 80286. no: affected 
beginning with 80386). CF. OF. PF. SF. 7.F 

Coding examples: 

.._ SL.3 
SAR OX, 16 

SAR TEMP.CL 


DescripHon: sar shifts all bit* in .he des.ina.ion operand .o ,he righ. bv .he num- 

ber ofplacesspcolied in the source operand loo, r.r^-,K . . ^ ^ i um 

bits are sc. equal .o .he exiMing high^rder bu “ '° S ' “ d h,ehwd " 


SBB: Subtract with Cam- 

Applicable processors- 80H(> 8088. 80286. 80386. 80-486 
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* - X 



i.ipn -r JJ )’r«Kcss«>r InMruujt m >cl» 


Category. \mhnutic inMruuion> 

~ sX- 

Flags affected \r. C T. t >|*. |>|: sf / 1 . 
Coding examples. 


sss 

S3S 

sse 

See 

S53 


1 '.5< 

- <,temp 

SJV.EBX 


AX,Tg.??(3X; 


:AX=AX SX CF 
;AX=AX TEMP CF 
;SUM*SUM EBX-CF 
^CL"CL.»0 CF 
; IncJirect address exarpie 


Description: S23 subtracts the contents of the source operand from (and stores the 
result m. the destination operand If the cany flag is set. the result changes in 

a decrement ol I In this instruction, the values being added arc assumed t nH\T~ 
birurv. r* —- 






SCASB: Scan String for Bvtc 
Applicable processors: 8080 8088. N 028 O WW 8 fi 80-.86 
Category: String-manipulation instructions 
Flags affected: AF. CF. OF. PF. OF. ZF 

Coding examples: 


SCASB 

REPNZ SCASB 


; Repeat a scan loop 


Description: SCASB subtracts the destination-operand string byte (pointed to by 
DI; from the value of A!.. The result is not stored, but the flags are updated. Then the 
value of DI changes in increments or decrements of 1, depending on the setting of 
the direction flag. Usually, this instruction is used with the REPE. REPNE. REPNZ. or REPZ 
instructions to repeat the scan for a maximum of CX bytes, or until SCASB finds a 
match or difference. Intel lists this command as SCAS: however, the assembler makes 
the bvte/word distinctions. 




SCASD: Scan String for Doubleword 

Applicable processors: 80386. 80-.86 
Category: String-manipulation instructions 
Flags affected: AF, CF. OF. PF. SF. ZF 
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Cod'*'# example* 


SCAS2 

P£?NZ SC~$C .«*-*«' 3 M * n 1000 

Description: scasc iubiracts the dot.nauonoparand vnnj, word I pointed jn b, 
cm, r r om the value«>f E.\N The result is not stored. but the flag* are updated. Then 
the Viluutf KDI changes in mefemente or decrements ol four. d «P* n *”l' un ' 1 * 
setting o. ihe^A-Wnn ila* L >u.db this ins.rtic.ion used 
se»n:. or R£p: instructions to repeal the scan lor a maximum ol CX torn or until 

match or difference i> found. 



SCASVC; Scan String for Viorel 

Applicable processors: Kt)S(> S*?SS. 80280. 80580. bd-ihO 
Category: String-manipulation instructions 
Flags affected: Ar. CF. Of. PF. SF. ZF 
Coding examples: 

SCAS'.v 

REPNZ SCAS.v ; Repeat a scan locp 

Description: SCAS.v subtracts the destination-operand string word (pointed to by 
DI) from the value of AN. The result is not stored, but the flags are updated. Then 
the value of DI changes in increments or decrements of two. depending on the 
setting of the direction flag Usually, this instruction is used with the AE?E. AEPNE 
REPN 7 ^ or REPZ instructions to repeat the scan for a mxximum of CX bytes, or until 
SCASv* and* a match or difference. Intel lists this command as SCAS: however, the 
assembler makes the byte word distinctions. 



SETA: Set Byte If Above 

Applicable processors: 80586. 80-i86 
Category: Data-transfcr instructions 
Flags affected: None 
Coding example: 

seta Cw 
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- - r ——^ 

Description: SETA stores a 1 In the operand tf the earn' and zero flags are both clear 
If this condition is not met. a zero is stored in the operand. The operand must be a 
byte-length register or memory location. This instruction is functionally the same as 
SETN8E. 



SETASrSe* Byte If Above or Equal 



Applicable processors: 80386 80-»86 
Category: Data-transfer instructions 


Flags aff' ted: None 
Coding example: 
SETAE CL 



Description: SETAE stores a 1 in the operand if the earn flag is clear If this condi- # 
tion is not met. a zero is stored in the operand The operand must be a byte-length 
register or memory location This instruction is functionally the same as SETNB or 
SETNC. 




SETB: Set Byte If Below 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 




SETB CL 

Description: SETB stores a 1 in the operand if the carry flag is set. If this condition 
is not met. a zero is stored in the operand The operand must be a byte-length register 
or memory location. This instruction is functionally the same as SETC or SETNAE. 



SETBE: Set Byte If Below or Equal 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
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Flags affected: None 
Coding example; 
SETBE CL 



Description: SETBE stores a 1 in the operand if either the cam- or zero flag is set. If 
this condition is not met. a zero is stored in the operand. The operand must be a b*te- 
length register or memory location. This instruction is functionally the same as 



SETC: Set Bvte on Carrv 

0 0 

Applicable processors: 80586, 80*86 ^ 

> 

Category. Data-transfer instructions 
Flags affected: None 
Coding example: 

SETC CL 

Description: SETC stores a 1 in the operand if the carry flag is set. If this condi¬ 
tion is not met. a zero is stored in the operand. The operand must be a byte-length 

register or memory location. This instruction is functionally the same as SETB or 
SETNAE. 


SETE: Set Byte If Equal 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 

Flags affected: None 

» • 

Coding example: 

SETE CL 

Description: SETE stores a 1 in the operand if the zero flaa is «». 1 1 .... 

.. , , _ If this condi- 

non is not met. a zero is stored in the operand. The operand must be a bvre-ien h 

register or memory location. This instruction is functionally the same as SET2 
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>et byte ir greater 

Applicable processors: 80386. 80486 
Category: Data-transfcr instructions 
Flags affected: None 
Coding example: 

SETS 


* 




jESFSsiiti"*. ,. r ; 


Description: SETG stores a 1 in the operand if the sign flag equals the overflow flag 
or if the zero flag is dear. If neither condition is met. a zero is stored in the operand. 
The operand must be a byte-length register or memory location. This instruction is 
functionally the same as SETNLE. 


SETGE: Set Byte If Greater or Equal 

Applicable processors: 80386, 80-i86 
C ategory: Data-transfcr instructions 
Flags affected: None 
Coding example: 

SETGE CL 

Description: SETAE stores a 1 in the operand if the sign Bag equals the overflow 
Qag. If this condition is not met, a aero is stored in the operand. The operand m 
be a byte-length register or memory location. This instruction s function ally the 

same as SETNL. 


SETL: Set Byte If Less 

Applicable processors: 80586.80486 
Category: Data-transfcr instructions 
Flags affected: None 
Coding example: 


SETL CL 
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Description: SETL stores a 1 in the operand if the sign flag does not equal the 
overflow flag If this condition is not met. a zero ft stored in the operand. The 
operand must be a byte-length register or memory location. This instruction is 
functionally the same as SETNGE. 


SETL&i Set Byte If Less or Equal 

Applicable processors: 80386, 80486 


Category: Data-transfer instructions 
Flags affected: None 


Coding example: 



•4WML nfiL 

Description: setle stores a 1 in the operand if the sign flag does not equal the 
overflow flag or if the zero flag is set. If neither condition is met. a zero is stored in 
r *.e operand The operand must be a byte-length register or memory location. This 
instruction is functionally the same as SETNG. 



SETNA: Set Byte If Not Above 


Applicable processors: 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SETNA CL 

Description: SETNA stores a 1 in the operand if either the cany or zero flei ta 
If neither condition is met. a zero is stored in the operand. The operand must (wT. 
byte-length register or memory location. This instruction Is functionally the same as 


SETNAE: Set Byte If Not Above or Equal 

Applicable processors: 80386. 80486 
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Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SETNAE CL 

Descrip HbnrSfTHAE stores a 1 in the operand if the cairy flag is set. If this con. ;.n ,r 
is not met. a zero is stored in the operand. The operand must be abyte-lengih register 
or memory location. This instruction is functionally the same as set B or setc. 





SETNB: Set Byte If Not Below 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SETNB CL 



Description: SETNB stores a 1 in the operand if the carry flag is clear. If this condition 
is not met. a zero is stored in the operand. The operand must be a byre-length register 
or memory location. This instruction is functionally the same as setae or setnc 


SETNBE: Set Byte If Not Below or Equal 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 



Flags affected: None 


Coding example: 


SETNBE CL 

Description: SETNBE stores a 1 in the operand if both the carry and zero flags are 
clear. If this condition is not met. a zero is stored in the operand. The operand musr 
be a byte-length register or memory location. This instruction is functionally the 
same as SETA. 
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SETNC: Set Byte on No Carry 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 

Flags affected: >*-- 

Coding example: 




SETNC CL 


_ Description: SETNC stores a 1 in the operand if the carry flag is clear. If this condi¬ 

tion is not met. a zero is stored in the operand. Thcf-operand must be a byte-length 
-registe r or memory location. This instruction is functionally the same as SETAE or 
SETNB. - . 


SETNE: Set Byte If Not Equal 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SETNE CL 

Description: SETNE stores a 1 in the operand if the zero flag is dear. If this condi¬ 
tion is not met. a zero is stored in the operand. The operand must be a byte-length 
register or memory location. This instruction is functionally the same as SETNZ. 


SETNG: Set Byte If Not Greater 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

8ETNG CL 
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Description: SETNG stores a 1 in the operand if the sign flag does not equal the 
overflow flag or the zero flag is set. If neither condition is met, a zero is stored in«he 
operand. The operand must be a byte-length register or memory location. This 
instruction is functionally the same as SETlE. 


SETNGE: Set Byte If Not Greater or Equal 

Applicable processors: 80586. 80486 



Category: Data-transfer instructions 

. JS _ fr. * 

Flags affected: None 
Coding example: 



SETNGE CL 

Description: SETNOE stores a 1 in the operand if the sign flag does not equal the 
overflow flag, if this condition is not met. a zero is stored in the operand. The 
operand must be a byte-length register or memory location. This instruction is 
functionally the same as SETL. 



SETNL: Set Byte If Not Less 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 



SETNL XL 

Description: SETNL stores a 1 in the operand if the sign flag equals the overflow 
flag If this condition is not met. a zero is stored in the operand. The operand must 
be a byte-length register or memory location. This instruction is functionally the 

same as setqe. 
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SETNLE: Set Byte If Not Less or Equal 

Applicable processors: 80386. 80-486 
Category: Data-transfcr instructions 



Flags affected: None 
Coding exariTple* 

SETNLE CL 




Description: SETNLE stores a 1 in the operand if the sign flag equals the overflow 
ag or the zero flag is clear. If neither condition is met. a zero is stored in the operand. 

The operand must be a byte-length register or memory location This instruction is 
functionally the same as SETG 


SETNO: Set Byte on No Overflow 

Applicable processors: 80386. 80-486 
Category: Data-transfcr instructions 
Flags affected: None 

Coding example: # 

SETNO CL 

Description: SETNO stores a 1 in the operand if the overflow flag is clear If this 

condition is not met, a zero is stored in the operand. The operand roust beabva 
length regbirer or memory location. ust pe a byte* 


SETNP: Set Byte on No Parity 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None- 
Coding example: 

SETNP CL 
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Description: SETnp stores a 1 in the operand if the parity flag is clear. If this condi¬ 
tion is not met, a zero is stored in the operand. The operand must be a bvre-lengrh 
register or memory location. This instruction is functionally the same as S6TP0. 


SETNSvSat Byte on Not Sign. 

Applicable processors: 80386. 80486 
Category; Data-transfer instructions 

Flags affected: None _ t r . _ 

Coding example: 

SETNS CL 

Description: SETNS stores a 1 in the operand if the sign flag is clear. If this 
tionf is not met. a zero is stored in the operand. The operand must be a byte-length 
register or memory location. 


SETNZ: Sei Byte If Not Zero 

Applicable processors: 80386. 80486 

Category: Data-transfer instructions ~ 

Flags affected: None 
Coding example: 

SETNZ CL - -=**■ 

Description: SE’NZ srores a 1 in the operand if the zero flag is clear. If this condi* 
tion is not met. a -zero is stored in the operand. The operand must be a byte-length 
register or memory location. This instruction is functionally the same as SETNE. 


SETO: Set Byte on Overflow 

Applicable processors: 80386. 80486 
Category; Daca-cransfer instructions 
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Flags affected: None 
Coding example: 

SETO CL 

Description: SETO stores a 1 in the operand if the overflow flag is set. If this condi¬ 
tion haw mrxj zero is stored in the operand. The operand must be a byte-length 
register or memortlOailuMi -- nznirmt 



t Byte on Parity 

Applicable processors: 80386. 80486 
Category: Data-transfer instructions 

■ .ij 1 ^ ~_ 

Flags affected: None 
Coding example: 


» snej* - 


SETP 


CL 




Description: SETP stores a 1 in the operand if the parity flag is set. If this condi¬ 
tion is not met. a zero is stored in the operand. The operand must be a byte-length 
register or memory location. This Instruction is functionally the same as SETPE. 


SETPE: Set Byte on Parity E\ 

Applicable processors: 80386.80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 


SETPE 


CL 


Description: SETPE stores a 1 in the operand if the parity flag is set. If this condi¬ 
tion is not met. a zero is stored in the operand. The operand must be a byte-length 
register or memory location. This instruction is functionally the same as SETP. 
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SETPO: Set Byte on Parity Odd 

Applicable processors: 80386, 80486 
Category: Data-transfer instructions 


Flags affected: None 
Coding example: 




SETPO CL 

Description: SETPO stores a 1 in the operand if the parity flag is clear. If this condi¬ 
tion Is not met. a zero is stored in the operand. The operand must be a byte-length 
register or memory location. This instruction is functionally the same as SETNP. 



SETS: Set Byte on Sign 

Applicable procrtsors: 80386,80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SETS CL 

Dcacriptkm: SETS stores a 1 in the operand if the sign flag is set. If this condition 
is not met, a zero is stored in the operand. The operand must be a byte-length regis¬ 
ter or memory location. 



SETZ: Set Byte If Zero 

Applicable processor*: 80386.80486 
Category: Data-transfer instructions 
Flags affected: None 


Coding example: 


SETZ CL 
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Description: SETZ stores a 1 in the operand if the zero nag is set. U this condition 
is not met, a zero is stored in the operand. The operand must be a byte-length register 
or memory location. This instruction is functionally the same as SETE. 


SGDT: Store GDTitegister * _< 

Applicable processors: 80286. 80386, 80486 
Category: Data-transfer instructions 




1: None 


Coding example: 

SCOT TEMP(BX] ~ 

W^ddre« n .« c D ifi!.T“ f T ' he b r es ° f the *‘° bal descri P'° r table 'O the mem- 
OO address specified in the operand. This instruction is used in protected-mode 

operating system software but not in applications software P ^ 




SHL: Shift Left 

Applicable processors: 8086/8088, 80286. 80386. 80486 
Category: Bit-manipulation instructions 

Flags affected: AF (undefined for all processors throueh 802ft6 «• 

beginning with 80386). CF.' OF. PF. SF. 2F ^ 80286, not affected 

f; * 

Coding examples: 

SHL AX,1 

SHL BL.3 

SHL OX,16 

SHL TEMP,CL 

Description: Shl shifts all bits in the destination operand to the left h - 
of pUces specified in the source operand. High-order bits are ins, thC number 

arc cleared. * 15 ,ost and low-order bits 
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SHLD. Shift Left, Double Precision 

Applicable processors: 80386. 80-*86 
Category: Bit-manipulation instructions 

Flags affected: AF (undefined). CF. OF (undefined). PF, SF. ZF 
Coding examples: 

SHLD AX.BX.4 

SHLD DW0R0_TEMP,EAX,16 

Description: Shld shifts ail bits in the first operand to the left by the number of 
places specified in the third operand. High-order bits are lost; low-order bi& ape 
copied from the second operand, starting with the second operand's low-order bit. 
The result is stored in the first operand. 


SHR: Shift Right 

Applicable processors: 8086/8088.80286. 80386, 80486 
Category: Bit-manipulation instructions 

Flags affected: AF (undefined for all processors through 80286. not affected 
beginning with 80386), CF. OF. PF. SF, ZF 

Coding examples: 

SHR AX, 1 

SHR - li.,3 ~~ 

SHR OX, 16 , 

SHR TEMP,CL 

Description: shr shifts all bits in the destination operand to the right by the number 
of places specified in the source operand. Low-order bits are lost and high-order bits 
are cleared. 


SHRD: Shift Right, Double Precision 

Applicable processors: 80386. 80486 

I 

Category: Bit-manipulation instructions 
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FUg 5 affected: AF (undefined). CF. OF (undefined). PF. SF. ZF 
Coding examples: 

•% 

SHRO AX,BX,4 - 

SHRO DW0R0.TBIP,EAX,16 . 

Description: SHRO shifts aU bits in the first operand to the right by the number of 
places specified in the third operand. Low-order bits are lost: h *f^ cr ^ ,t4 ^ 
copied tom the second operand, starting with the second operand s high-order bit. 

The result is stored bMhe first operand. 


5IpT- Store Interrupt Descriptor Table Register 




Applicable processors: 80286. 80386, 80486 
Category: Data-transfer instructions 
Flags affected: None 
Coding example: 

SIOT TEMPfBX] 

SIDT transfers the six bytes of the interrupt descriptor table to the 
memoir address specified in the operand. This instruction:is used in protected- 
mode operating system software but not in applications software. 


SLOT: Store Local Descriptor Table Register 

Applicable processors: 80286. 80386. 80486 

Category: Data-transfer instructions 

Flags affected: None 

Coding examples: 

SLOT AX 

SLOT LDT_TEMP 

_ _ slot copies the contents of the local descriptor table to die two bytes 

Description^ instruction is used in protected-mode operating system 

ftware but not in applications software. 
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SMSW: Store Machine Status Word 

Applicable processors: 80286. 80386. 80486 
Category: Data-transfer instructions 
Flags affected: None 





Description: Smsw copies the value of machine sums word to the operand. This 
instruction is used in operating system software only, not In applications software. 




STC: Set Carry Flag 

Applicable processors: 8086/8088, 80286,80386, 80486 



Category: Flag- and processor-control instructions 
Flags affected: CF 
Coding example: 

STC 


* 



Description: STC sets the carry flag regardless of the flag's present condition. 



STD: Set Direction Flag 

Applicable processors: 8086/8088,80286,80386,80486 
Category: Flag* and processor-control instructions 
Flags affected: DF 



Coding example: 

6 

STD 

Description: ST0 sets the direction flag regardless of the flag's present condition. 
This setting affects the string instructions. 
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STI: Set Interrupt Flag 

* "* V. ,, • 

Applicable processors: 8086/8088, 80286,80386,80486 


Category: Flag- and processor-control Instructions 
Flags affected: IF 

rjWLseer - 

Description: STI sets the interrupt flag regardless of the flag's present condition. 
While this flag is set, the CPU responds to maskable interrupts. 




STI - 


STOSB: Store Byte in AL at String 

Applicable processors: 8086/8088, 80286, 80386, 80486 


Category: String-manipulation instructions 
Flags affected: None 

— ‘ 

Coding example: 

STOSB 

Description: STOSB copies the contents of AL to the byte address pointed to by DI. 
DI then changes in increments or decrements of 1, depending on the setting of the 
direction flag. Intel lists this command as ST0S; however, the assembler makes the 
byte/word distinctions. 



STOSD: Store Doubleword in EAX at String 

Applicable processors: 80386, 80486 
Category: String-manipulation instructions 
Flags aflTccted: None 
Coding example: 

STOSD 

Description: STOSO copies the contents of EAX to the word address pointed to by 
EDI. DI then changes in increments or decrements of four, depending on the scttina 
of the direction flag. 

a 1 
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STOSW: Store Word in AX at String 

Applicable processor*: 8086 8088 80286 HO M H<>iW, 

Category: Mring-tuanipul.it ion instruction* 

Flags affected: None 

Coding rmmplet 

stosw 

Description. siosw i opics the contents of AX to the word address pointed to tn Ld, 

, l ^ Cn than « es in incrcmt ' n «' or decrements of m o, depending on the XilwtLOL 
the direction flag. Intel lists ,hi- rommand as *5T0?. however, the assembler makes 
the byte word distinctions 


STR: Store Task Register 

Applicable processor*: 80286 80386. 80*86 
Category': Data-transfcr instructions 
Flags affected: None 
Coding examples: 


STR 

STR 


AX 

MSW TEMP 


Description? Str copies the value of the task regi"';r to tftilf^'io'perand. tk ic 
instruction is used in operating system software only, i: b not used in applicauons 
software. 



SUB: Subtract 

Applicable processors: 8086 8088. 80286. 80386, 80*86 
Category: Arithmetic instructions 
Flags affected: AF. CF. OF. PF. SF. ZF 
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Coding examples: 

SU8 AX.BX ;AX»AX-BX 

SUB AX, TE’JI? ;AX*AX-TEMP 

SUB SUM,E3X ;SUM*SUM-E9X 

SUB CL,tO ;CL*CL-10 

SUB AX.TEMP(BX) ;Indirect address example 

Description: SUBsubtracts the contents of the source operand from (and stores the 
result in) the destination operand. In this instruction, the values being added are 
assumed to be binary. 



TEST: Test .Bits 

Applicable processors: 8086 8088. 80286. 80386. 80-*86 
Category: Bit-manipulation instructions 

Flags affected: AF (undefined for all processors through 80286, not affected 
beginning with 80386). CF. OF, PF, SF, 2F 

Coding examples: 


TEST AX, TEMP ;TEMP must be a word >> 

TEST SUM.E3X ;SUM must be a doubleword 

TEST CL,Cv90l 111b ; 

TEST AX,TEMP(BX) jlndirect address example 

Description: TEST performs a logical AND of the operands, but the result is not 
stored. Onl> the flags are affected. Each bit of the resultant byte or word is set to 1 
only if the corresponding bit of each operand is set to 1. 



VERR: Verify a Segment for Reading 

Applicable processors: 80286. 80386. 80-486 

Category: Flag- and processor-control instructions 

Flags affected: ZF 

Coding examples: 

VERB TEMP 

VERR AX 


i 
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Description: determines whether the selector specified in the operand is 

visible at the current pro ilcge level and t> rvubWf The zero flag is set ii the selector 
is accessible 


VERW: Verify a Segment for Writing 

Applicable pro* rssors sujso 8f-'S6. so «so 
Category: Hag aiul poKessor-control instrut tions 

Flags affected; l\ 

Coding examples 


vE*a 

VESA 


T£V3 

U 


Description: ve*a determine' whether the selector specified in the operand is 
visible at the current privilege level and tan be written The zero flag is set if the 
selector is accessible 


WAIT: Wait 

Applicable processors 8U8(> 8U88. 80JM6. 80*80. 80-iSo 
Category-. Flag- and processor-control instructions 

Flags affected: None 
Coding example: 

WAIT 

Description, wan causes the CPC to wait lor an external interrupt on the test lmr 
before continuing 


WBINVD: Invalidate Cache and Write Back 


Applicable processors: 80486 

Category: Processor-control instructions 
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Flags affecied: None 
Coding examples: 

WBINVD 

Description: This instruction is similar to the INVD instruction. It results in the 
internal (on-chip) data cache being flushed, but the special-function bus cycles that 
follow’ are different. Twc of the bus cycles are issued: the first is an instruction to 
external caches to write their tnfonnauon back to main memory; the second 
instructs the caches to flush their contents (same as INVD). 


- - y - “■*<*,*• • rx 4 iM 


XADD: Exchange and Add to Memory 

Applicable processors: 80486- „ 


Category: 


Data-transfer instructions 


Flags affected: AF. CF OF. PF. SF. ZF 
Coding examples: 

XADD EAX,EBX 



Description: Exchanges the values in the two operands before doing an addition 
Functionally equivalent to exchanging and adding wuh multiple instructions 



XCHG; Exchange 

Applicable processors: B086/8088. 80286. 80386. 80-»86 
Category: Data-transfer instructions 
Flags affected: None 
Coding examples: 


XCHG 

AX.BX 

;Swap AX with BX 

XCHG 

EAX,DW0RD_TEMP 

;Swap EAX With DW0R0_TEMP 

XCHG 

CL.CH 

;Swap CL with CH 

XCHG 

AX,TEMP 

•Swap AX with TEMP (word) 


Description: xchg swaps the contents of the source and de<r 

operands must be of equal length. unation operands. The 
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XLAT: Translate 

Applicable processors: 8086/8088. 80286. 80386. 80486 

Category: Data-transfer instructions 

Flags affected: None 

Coding example: ' ~■-* 

XLAT 

Description: Assuming that the offset address of a 256-byte translation table is 
contained in BX. this instruction uses the value in AL as a zero-based offset into the 
table, and subsequendy loads AL with the byte value at that calculated offset. This 
instruction is helpful for translation tables. 




XOR: Logical Exclusive-Or 

Applicable processors: 8086/8088, 80286, 80386, 80486 
Category: Bit-manipulation instructions 
Flags affected: AF (undefined), CF, OF, PF, SF, ZF 
Coding examples: 


XOR 

AX,BX 

• 

» 


XOR 

EAX.TEMP 

;TEMP must 

be a doubleword 

XOR 

SUU.BX 

;SUM must 

be a word 

XOR 

CL,00001111b 



XOR 

AX,TEMP(BX1 

;Indirect 

address example 


Description: XOR performs a logical XOR of the operands and stores the result in the 
destination operand. Each bit of the resultant byte or word is set to 1 only if the 
corresponding bit of each operand contains opposite values. 
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CHAPTER 



. 


Assembler Directives 




A ssembler directives are mentioned and used thtwQghout this book. In fact. 

doing any assembly language programming without using at least a few 
directives is difficult, if not impossible. 

The basic mnemonic language used by assemblers cannot be expanded; it is set 
by the microprocessor for which the assembler was written. To make the language 
more versatile, assembler-writers have taken to expanding the languUgLlJJ' JiMing. 
directives and have expanded or extended instructions. 

The range of directives available is quite impressive. Many of them you will use 
daily, whereas others you mayuse onlyonceinaw'hile. InChapter3. "Choosingand 
Using Your Assembler.” you learned about directives—what they arc and how they 
are used in a general sense. This chapter is a comprehensive reference to alLtbc ^ s , 
■ directives available with both MASM and TASM. 

. . _ „ ^ -mil >. . 

Thtf-chapter does not cover the additional or exteniTfil tu nw—imifc ji n are 
available with some assemblers. For instance, Turbo Assembler 3 0 has modifie 
way in which some instructions, such as PUSH and POP, operate. These arc considered 
extended instructions , since they expand the basic capabilities of existing mne- 

—nin 

Additional instructions . on the other hand, arc instructions that do not fail 
clearly into the directive category, but add to the basic instruction set. During 
assembly, they generally expand into a series of instructions that accomplish a 
discrete task. Examples are the smart flag instructions available with Turbo Assem¬ 
bler 30 ^ 
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Directive Categories 






In this reference, each directive is categorized into one of the following general 
categories: 

□ Control flow 


□ Processor specification 

□ Global control 

Zi Simplified segment control 
Zi Complete segment control 

□ Procedures and code labels 

□ Scope and visibility 

□ Data allocation 


□ Macros and repeat blocks 

□ Conditional assembly 

□ Conditional error 

□ Listing control 

□ String control 

r 

iJ Miscellaneous 


Q Complex data types ~ 

that a“^ U f 5 . , t ! n8 ' C r‘ r018r ° Uf> ' nCOmp “ ses thc mo « directives. Note also 

same Sk ^T e r “ UV “ sim P»’duplicate ways to accomplish the 

same task. (In effect, they are synonyms of each other.) 

than ‘ l00kl ' e l Ch of lhese “«gories. Note that some directives appear in more 

pcrform more lhan one -* -TS 


- Processor Specification 

This group of directives is used to soeciiv rh,. 
the assembler to generate code. Different directives con^oV f ° r which you want 
numeric coprocessor, and the type of instructions fnr™ ? Ac P rocessor . the 
^ be generated for each processor. The directives arenas follows" 10 ^’ C ' C * lhat Can 

1 AA _ 


.186 
.286 
.286C 
. 286P 
.267 
.386 


. 386C 
. 386P 
.387 
.486 
. 486C 
. 406P 


.8086 

.8087 

• N087 

P186 

P286 

P286N 


P286P 

P287 

P386 

P386N 

P386P 

P387 


P400 

P486N 

P8086 

P8087 

PN087 
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Simplified Segment Control 

Simplified segment control is a great aid in developing assembly language 
programs. With these directives, you can leave many of the details of segment 
grouping and ordering to the assembler and linker: 


ASSUME 

.DATA 

.FARDATA 

.STARTUP 

.COOE 

.DATA? 

FAADATA 

STARTUPCODE 

COOESEG 

DATASEG 

, FARDATA? 

UDATASEG 

.CONST 

.EXIT 

.MODEL 

UFARDATA 

CONST 

EXITCODE 

MODEL 




Complete Segment Control 

These are the directives to use when you want complete control over the way 
segments are handled by the assembler and linker. Use of these directives has 
decreased dramatically since the advent of the simplified segment-control directives. 


.ALPHA 

OOSSEG 

ORG 

SEQ 

ALPHA 

END * 

SEGMENT 

.STACK 

ASSUME 

ENDS 

.SEQ 

STACK 

.DOSSEG 

GROUP 
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, ^ ^ ~ ^y^?sses3»r 

t >JL^ 

Procedures and Code Labels 

These directives are used in the definition and use of procedures, and labels 
(symbolic names) in those procedures: 


ARG 

LABEL 

NOLOCALS 

PROTO 

ENOP 

LOCAL 

PROC 

USES 

INVOKE 

LOCALS 


; ' tT 


Scope and Visibility 

Scope has to do with how accessible a label is to other modules, and visibility 
has to do with whether certain labels can be located by the current module. These 
directives control both these items: 

COMM EXTRN INCLUDE PUBLICDLL 

EXTERN GLOBAL INCLUOELIB PUBLIC 

EXTERNOEF 


Data Allocation 

These directives cause the assembler to allocate memotv in the OBJ file for 
your data: 


BYTE 

OT 

QWORD 

SDWORO 

DB 

DW 

REAL4 

SWORD 

DO 

DWORD 

REAL8 

TBYTE 

OF 

OQ 

REAL10 

WORD 

OP 

FWORD 

SBYTE 


Complex Data Types 



Relatively new to assembly languagi 
data types. These include user-defined 
records The directives follow: 

c programming is the 
pointers, structures. 

concept of complex 
unions, tables, and 

ALIGN 

EVEN 

STRUC 

TBLPTR 

ENDS 

EVENDATA 

STRUCT 

TYPEDEF 

ENUM 

RECORD 

TABLE 

UNION 
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Control Flow 
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in the past, assembly language programmers have had to write their own 
control structures, generally to handle looping Because this can be confusing to 
many programmers who are used to the wavs in which this is done in high-level 
languages, this group of directives w as created. 



.ELSEIF 

.IF 

- ... 

.UNTILCXZ 


.CONTINUE 

Tendif 

.REPEAT 

.WHILE 


.ELSE 

.enow 

'.UNTIL 




Macros and Repeat Blocks 

Macros have long been a part of the collection of tools available to assembly 
language programmers. Theoretically, macros make programming easier. Lniess - 
the macros are well documented, however, the job of maintaining the code can be 


difficult later. 






ENOM 

GOTO 

MACRO 


REPT 


EXITM 

IRP 

PURGE 


TEXTEQU 

* 


FOR 

IRPC 

REPEAT 


while 


FORC 

LOCAL 

—_a 





Conditional Assembly 

Conditional assembly directives allow you to control winch portions of your 
source code are assembled, based on flags and other control statements you devise. 


ELSE 

IF1 

IFDIF 

IFIONI 

ELSEIF 

IF2 

IFOIFI 

IFNB 

ENOIF 

IFB 

IFE 

IFNDEF 

IF 

IFOEF 

IFIDN 



Conditional Error 

This catettory of directives is similar to the conditional assembly directives, in 
that thev control how the assembler does its work, based on a detected condition 
during the assembly process This group of directives allows you to control when 
crrorsare generated TvpicaUy. these directives are used in macros 10 ensure that the 
u:»cr parses the proper parameters. 
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.ERR 

.ERROIFI 


ERRIFB 

errifidni ' 

ERR 

.ERRE 


ERRIFDEF 

ERRIFNB ' • 

.ERR1 

.ERRION 


ERRIFDIF 

ERRIFNDEF 

.ERR2 

.ERRIDNI 


ERRIFOIFI 

.ERRNB 

. ERRB 

ERRIF 

* 

ERRIFE 

• m t 

.ERRNOEF 

.ERRDEF 

ERRIF1 


ERRIFION 

.ERRNZ 

.ERRDIF 

* s 

^^' , '*TPRIF2 


- - - 

* ■ - " “ • 

Listing 

Control 




The largest of the directive groups, these directives affect how ihe listing file 

is generated. U includes directives that change the appearance of the information 

printed, as well as what is and is 

not included in the listing. 


%BIJM 

%LIST , 


%N0LIST 

«,* * 

.SFCONO 

%CONDS 

;LIST 


.NOLIST v 

SUBTITLE 

%CREF 

.LISTALL 


-NOLISTIF 

- %SUBTTL 

.CREF 

.LISTIF 


.NOLISTMACPO 

- - SUBTTL 

SCREFALL 

.LISTMACRO 


> \NOMACS 

SSYMS 

%CREFREF 

•LISTMACROALL 

VJOSYMS 

%TABLSIZE 

%CREFUREF 

V.IACS 


%N0TRUNC 

%TEXT 

%CTLS 

SNEVVPAGE 


PAGE 

•TFCONO 

HDEPTH 

VJOCONOS 


SPAGESIZE 

vitle 

%INCL 

%N0CREF 


%PCNT 

title 

.WLt 

.NOCREF 


' %P0PLCTL 

VTRUNC 

.LFCOND 

\NOCTLS 


%PUSHLCTL 

.XALL 

%LINUM 

%NOINCL 

> * 

• SALL 

•XCREF 





.XU ST 

String Control 





This is the least-populated group. It consists of the following four directives 
which manipulate strings assigned to text macros 
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CATSTR 

INSTR 

SIZESTR 

SUBSTR 


n ''v 

Miscellaneous 




The six “left-over” directives in this category do not fit in the other groups: 


COMMENT 

DISPLAY 


*0UT 


. «a»t > 


Detailed Directive Information ****"- 

In the remainder of this chapter, each directive available with TASM and MASM 
is described in detail. The following information is given for each instruction^-- 

□ Directive name. This name is based on the names provided by Microsoft 

and/or Borland. _ 

□ Applicable assemblers. This paragraph lists the assembler versions that 
perform the directive. 

□ Directive category. The general classification for the directive is provided. 

□ Syntax. A quick notation of the proper and full way in which the directive 
can be used. 

* W W ~ * 

□ Description. A narrative description of each directive is provided. 

□ Example. If it would be instructive, a brief example or two of the use of the 
directive. If the syntax of the directive is too simple to warrant an example, 
none is given. 



Assign a Value to a Label 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6.0. 
TASM 2.0. TASM 3 0 
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Directive category: Miscellaneous 
Syntax: 


label a value 

Description: This is one of the most used direct, ves ,n any assembler although 
£ople rarely stop to think of it as a directive The equal s,gn ts used to assign a valfe 
o a user-designated label It is similar ,n purpose and function to the EQu directive 
l sing the equal sign does not result in storage space (memory area; being assigned 

•"rrT “ |US< ^ SlgnS 1 Valu<! to 3 labeI '^1 can then be u*d in £hct 
of the value later in the program L seofthf emni cionH «e. V 

clarity and maintainability. q 8 '"'"*** P ro ^ m 

The expression following the equal sign must be equivalent, in some wav to 
an integer value: it can be a number, a formula that can be resolved to a number up 

Ihc^ 

1 ? e - < !i ff u rCnCC bctWeCn lhe tqual si » n and lhc EQ'J directive is that values 
5 ' 8n ""^ ChangCd ^ 1 ^ 3 •— - -h ECU. 

Examples: 


Mono 

Color 

MaxRows 

Affirmative 

TableStart 


0B000h 
0B800M 
25 * 80 
•V 

THIS BYTE 


I y ono video buffer start 
;Color video buffer start 
Regular screen ? ize 
;Acceptable Keypress 
;Table starts hern 


. 186 : Enable 80186 Programming 

Applicable assemblers: Microsoft Quick Assembler 2 51 ViASM 5 i mac** ^ 
TASM 2.0. TASM 3 0 “ 1# MA5M 6.0, 

Directive category: Processor specification 

Syntax: 

.186 

Description: Both MASM and TASM allow you to program for Cn _ e 

sore. The default processor is the 8086 This directive causes thf^ ' cro proces- 

instructions compatible with the 80186 microprocessor ^ irndle 

„ you are using TASM. ihis direcive is cquiwUen, ,o thc Fm dlfcct , v< . 
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.286: Enable 80286 Programming 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, MASM 6 0. 
TASM 2 0. TASM 3.0 


Directive category: Processor specification 




.286 

Description: Both MASM and TASM allow you to program for speciiic micro¬ 
processors. The default processor is the 8086 This directive causes the assembler 
to handle instructions compatible with the 80286 microprocessor. 

If you are using TASM, this directive is equivalent to the P 286 N directive. 




.286C: Enable 80286 Nonprotected-Mode Programming 

Applicable assemblers: Microsoft Quick Assembler 2.51. TASM 2.0, TASM 3 0 

Directive category: Processor specification 

Syntax: 

.286C 

Description: This directive is functionally equivalent to the .286 directive, and the 
opposite of the .286P directive. With it, you can program for the 80286 processor, 
but the assembler makes sure that you use no instructions that require protected 

If you are using TASM, this directive is equivalent to the P 286 N directive. 



.286P. Enable 80286 Protected-Mode Programming 

Applicable assemblers: MASM 6.0. TASM 2.0. TASM 3-0 

Directive category: Processor specification 

Syntax: 

.286P 
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Description: Both MASM and TASM allow you to* program lor specific micro¬ 
processors. The default processor is the 8086. This directive causes the assembler 
to handle instructions compatible with the 80286 microprocessor. The difference 
between this and the .286 directive is that when this directive is used, you can 
program Tor protected-mode operations. 


If you are using TASM. this directive is equivalent to the P286P directive. 



.287: Enable 80287 Programming 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, MASM 6.0. 
TASM 2.0. TASM 3.0 - — ... ^ 

Directive category: Processor specification 
Syntax: 


^ 287 

' -- ■ 

Description: Both MASM and TASM allow you to take advantage of numeric 
coprocessors in your programs. By default, the assembler allows you to code for the 
808" NPX. This directive causes the assembler to handle instructions compatible 
with the 8028" numeric coprocessor. 

If you are using T.ASM. this directive is equivalent to the P287 directive 


.386: Enable 80386 Programming 

Applicable assemblers: MASM 5.1. MASM 6.0. TASM 2.0. TASM 3.0 

Directive category: Processor specification 

Syntax: 

.386 

Description: Both MASM and TASM allow you to program for specific micro¬ 
processors. The default processor is the 8086. This directive causes the assembler 
to handle instructions compatible with the 80386 microprocessor, including in¬ 
structions that use the expanded register set of the 80386. 

If you are using TASM. this directive is equivalent to the P386N directive. 


Scanned by CamScanner 




.386C: Enable 80386 Nonprotected-Mode Programming 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: Processor specification 
Syntax: 

.386C 

Description: This directive is functionally equivalent to the .306 directive, and the 
opposite of the .386P directive. With it. you can program for the 80386 processor, 
but the assembler makes sure that you use no instructions that require protected 
mode. 

If you are using TASM, this directive is equivalent to the P3S6N directive. 


•386P: Enable 80386 Protected-Mode Programming 

Applicable assemblers: MASM 6 0. TASM 2.0. TASM 3.0 
Directive category': Processor specification 
Syntax: _ — 


Description: Both \L\SM and TASM allow you to program for specific microproces¬ 
sors. The default processor is the 8086. This directive causes the assembler to handle 
instructions compatible with the 80386 microprocessor The difference between 
this and the .386 directive is that when this directive is used, you can program for 
protected-mode operations. 

If you are using TASM, this directive is equivalent to the P3B6P directive. 



.387: Enable 80387 Programming 

Applicable assemblers: MASM 6.0. TASM 2.0, TASM 3 0 

Directive category: Processor specification 

Syntax: 

.387 
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Description: Both MASM and TASM allow you to take advantage of numeric 
coprocessors in your programs. By default, the assembler allows you to code for the 
808“ NPX. This directive causes the assembler to handle instructions compatible 
with the 8038“ numeric coprocessor. 

If you are using TASM. this directive is equivalent to the P387 directive. 

♦ 

.486: Enable 80486 Programming 

Applicable assemblers: MASM 6.0. TASM 3 0 
Directive category: Processor specification 
Syntxx: 

.486 

Description: Both MASM and TASM allow you to program for specific microproces¬ 
sors. The default processor is the 8086. This directive causes the assembler to handle 
instructions compatible with the 80-i86 microprocessor. This includes instructions 
that use the expanded register set of the 80486 

^ou should note that the .486 directive enables the use of instructions 
designed to take advantage of the NPX built into the 80486 . If your code is designed 
to ultimately run on the 8 O 486 SX chip, make sure that you do not use instructions 
which require the NPX. Even though the assembler will allow them (after this 
directive is executed), the resulting code w ill not run on the 80486 SX. 

If you are using TASM. this directive is equivalent to the P486N directive. 

rail, 

486C: Enable 80486 Nonprotected-Mode Programming 

Applicable assemblers: TASM 3.0 
Directive category: Processor specification 
Syntax: 

486C 

Description: This directive is functionally equivalent to the .486 directive and the 
opposite of the .486P directive With it. you can program for the 80486 processor 
(including instructions that use the expanded register set of the 80486) but the 
assembler makes sure that you use no instructions which require protected mode. 
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If you are using TASM. this directive 


is equivalent to the P486N directive. 



.486P: Enable 80486 Protected-Mode Programming 

Applicable assemblers: MASM 6.0. TASM 3 0 


Directive category: Processor specification 
Syntax: 




.486P 



Description: Both MASM and TASM allowyou to program for specific microproces¬ 
sors. The default proccs'sor is the 8086. This directive causes the assembler to handle 
.instructions compatible with the 80486 microprocessor. This includes-instructions 
that use the expanded register set of the 80486. The difference between this and the 
.486 directive is that when this directive is used, you can program for protected- 
mode operations. 


Note that this directive enables the use of instructions designed to take 
advantage of the NPX built into the 8O486. If your code is designed to ultimately run 
on the 80486 SX chip, make sure that you do not use instructions which require the 
NPX. Even though the assembler will allow them (after this directive is executed), the 
resulting code will not run on the 80486 SX. n _ 


.8086: Enable 8086 Programming 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6.0. 
TASM 2 .0, TASM 3 0 

Directive category: Processor specification 
Syntax: 

.6086 

Description: This is the default programming paradigm for both MASM and TASM. 
Although you can use other directives to enable various levels of processor 
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compatibility. this directive enn be used to make absolutely sure that your program 
will \\ ork v\ ith al! members of the 80x86 family. 

A typical use of this directive is when you have been programming for a 
different level of compatibility fS02S6 or higher) and you want to make sure that the 
cixic being written will assemble into a final finished program that will then be able 
to run on an older processor. Using this directive helps ensure that, bv enforcing 
which instructions are allowed to be used. 

If you are usir.g TASM. this directive is equivalent to the P8056 directive. 


.8087: Enable 808*^ Programming 


Applicable assemblers: Microsoft Quick Assembler 2 si. MASM 5 1 MASVl 6 0 
TASM 2.0. TASM 3 0 

Directive category: Processor specification 


Svntxx: 

.8087 

Description: This is the default programming capabilirv of both MASM and TASM 
You can use this directive to state expliciry in your program that vou are program^ 
ming for the 808' numeric coprocessor, but use of the directive is not mandatory. 

If you are using TASM. this directive is equivalent to the P 8287 directive. 

^ ALI GN« Adjust the Assembler Location Counter 

* * « er Applicable assemblers: Microsoft Quick Assembler 2 51 MASM 5 1 MASVt 6 n 

TASM 2.0, TASM 3 0 ’ ' 

Directive category: Global control, complex data types 

Syntax: 


ALIGN Doundary 


Dc »crip.io n: AUG" is used to designate where the assembler should place the 

assembled .nformat.on immediately following the d.recme. For instance vou may 

need to have data placed at a specific word doublcwnrH ^ . * 0 ^ 

. uuoicword, or paragraph boundary*. 

This -directive is used to accomplish the task. r & y y 
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align 
the sa 

using i asm. 



Examples: 


ALIGN WORD 
ALIGN PARA 
ALIGN 4 


;Align to word Dounaary 
;Align to paragraph boundary 
;Align to doubleword boundary 



•ALPHA: Place Segments in Alphabetic Order 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6.0 
TASM 2.0. TASM 3 0 

Directive category: Complete segment control 
Syntax: 


.ALPHA 


Description:-Normally, the assembler places segments in the OBJ file in the 
order in which they occur in the source file. You can override this, however, with the 
.alpha directive. Typically, you would use this directive only if there were a specific 
need to do so. For example, early versions of MASM (10. 2.0. and 3 0) put segments 
in alphabetical order by default; if you are working with source code developed for 
early versions of MASM. you may need to use this directive to ensure compatibility. 

You can affect the ordering of segments with the . D0SSEG, D0SSEG.. SEQ. and seo 
directives also. 



ARG: Specify Arguments Passed on the Stack 

Applicable assemblers: MASM 5.1. TASM 2.0. TASM 3 0 
Directive category: P.ocedures and code labels 
Syntax: 

ARG argument[, argument] ... (=labei) [RETURNS 
argument[, argument) ...) 
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where each argument has the following construction: 
l-ise! (( arraySLze] 1 l: (de&ugsizi) | typel (:cot-nf) ] 

Description: This directive cun be used to specify arguments being passed from a 
high-level language Each argument has. at minim.um. a label name and a type, such 
as WORD or DWORD In the syntxx for the directive, the label following the equal 
sign can be used with the RET instruction at the end of the routine to clean up the 
stack (if necessary-): the assembler automatically assigns the collective length of the 
arguments to this label. 

In effect, the arg directive, like the EOU statement, is a way of specify ing rigid 
equates that point onto the stack. For instance, each argument specified u ith the arg 
directive is treated by the assembler as an offset on the stack. Thus, the statement 

ARG First, Second, Third:WORD 

may be functionally equivalent, later in the program, to 

First EOU (BP*4) 

Second EOU (BP*6) 

Third EOU 13P+8J 

Every time the "‘sembler subsequently encounters the label, it substitutes the 
pointer onto the stack. Clearly, the EQu values used depend on the programming 
model (see .MGOEL) being used by the assembler. 

This directive is not available in MASM 6.0. W'ith MASM 6.0. you specify 
arguments in the PROC declaration at the beginning of the subroutine. 



ASSUME: Assign Segment Registers 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6 0, 
TASM 2.0. TASM 3-0 

Directive category: Simplified segment control, complete segment control 
Syntax: 

ASSUME [segmentreg:)name (, seg/nentreg: name] ... 

Description: This directive is used to specify which user-defined segment names 
should be associated with which segment registers. The segment reg can be CS DS 
ES. SS, FS. or GS. The name can be any user-defined segment name, or the SDecial 
name NOTHING. If the name is not NOTHING, segmentreg is required. The nam» 
must also correspond to a name declared using a GROUP or SEGMENT directive 
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Examples: 

ASSUE CS -COOESEG, OS: DATASEG, ES:NOTHING 
ASSUME CS-.COOESEG, OS .COOESEG 
ASSUME NOTHING 


%BIN: Set Listing-File Object-Code Field Width 

Applicable assemblers: MASM 5.1, TASM 2.0, TASM 3 0 

Directive category-: Listing control 

Syntax: 

%6IN width 

Description: VThen you have requested a listing file (LST file) during assembly, this 
directive controls the width of the object-code field. The default value is 20 
characters wide, but you can set it to any reasonable value. ' 


.BREAK: Terminate a REPEAT or .WHILE Loop 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

.BREAK [.IF condition] 

Description: When you are using the .REPEAT or .while directives to control 
program flow, you can use the .break directive to terminate control of the loop. 
Thtsdirective is another example of the way in which MASM is mutating toward high- 
level language coding and constructs. In this case, .break funcuons in the same 
manner as the BREAK statement in C. 

The condition used by the loop must resolve to either true or false. It can be 

complex in nature (testing for two or more conditions) and may contain any of die 


following operators: 
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Operator Meaning 


= = 

Equal 

1 = 

Not equal 

> 

Greater than 

> = 

Greater than or equal to 

< 

Less than 

< = 

Less than or equal to 

& 

Bit test 

&Sc 

Logical AND 

II 

Logical OR 

i 

Logical NOT 


You also can test automatically ihe condition of flags by using the following 
specialized flag-name operators: 

Operator Sample Use 


CARRY? 

.BREAK .IF (CARRY?) 


OVERFLOW? 

-BREAK .IF (OVERFLOW?) 

• 

PARITY*' 

-BREAK .IF (PARITY?) 


SIGN? 

.BREAK .IF (SIGN?) 

• 

ZERO’ 

.BREAK .IF (ZERO?) 


Example: 

.REPEAT 

;Wait for the Enter key 

to be pressed 

MOV AH,7 

;0irect character input 

without echo 

INT 2lh 

;00S services 


.BREAK .IF AL 

== 27 ;Jump out if Esc was pressed 

.UNTIL (AL ” 

13) ;Keep going until Enter 

is pressed 



BYTE: Allocate a Byte of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntx\: 

llabel| BYTE expression , expression ) 
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Description: This directive is equivalent to the DB directive. It is used to allocate 
memory in the executable file for data storage. The label is a user-defined name you 
can use later to refer symbolically to the stored information. Each expression must 
be one of the following: 

J A number between -128 and 255 

□ A formula resolving to a number between -128 and 255 

□ Text characters 

□ A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DL'P operator to specify multiple occurrences of the data 
in the expression. 

If the data allocated by the BYTE directive is actually longer than a single byte, 
the label refers only to the first byte of the allocated data. 

If you are working explicitly with signed data, you can use the SBYTE directive 


also. 



Examples: 

ValidKeys 

BYTE 

'YyNy' 

ULCol 

BYTE 

00 

BoxSize 

BYTE 

5 * 7 

Buffer 

BYTE 

2048 DUP(?) 

Stack 

BTYE 

128 DUP('STACK 



CATSTR: Concatenate Strings 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: String control 

Syntax: 

label CATSTR string[, stringl .•- 

Description: This directive, which is used to make string building easier, can be 
used also to convert numbers to ASCII text. This conversion takes place during 

assembly, not at run-time. 

The \ ahpi is a user-defined name you can use later to refer symbolically to the • 
ine laoei Q f the foUowi 

new string. Each string can dc e* 
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J A siring enclosed in angle brackets (< >) 

□ An existing text macro 

■J A percent sign followed by a number to be included in the text string 


It is important that you realize that the resulting string is not stored in the 
executable file; rather, it is used by the assembler for later substitutions. In this 
way. catstr is functionally equivalent to the TEXTEOU directive (available onlv in 
MASM 6.0). 

Examples: 

BoxSize BYTE 5 * 7 

BoxMessage CATSTR <The size of the box is >, %BoxSize, < units.> 


.CODE: Define Beginning of Program Code 


Applicable assembi rs: Microsoft Quick .Assembler 2 31 MASM 6 0 TASM 2 0 
TASM 3 0 .... 


Directive category: Simplified segment control 
Syntax: 

COPE [name] 

Description: If you are using simplified segment directives, you will be using the 
.CODE directive, which is used to inform the assembler that the information 
immediately following should be planed in the code segment. You must use the 
.MODEL directive before using .CODE. 

If you are using the medium, large, or huge memoir model, you can use an 
optional name with .CODE; otherwise, the name is ignored. If you do not proride a 
name, the assembler creates one automatically from the module name. Later the 
linker uses this name to concatenate and order segments. ' 



CODESEG: Define Beginning of Program Code 

Applicable assemblers: TASM 2.0, TASM 3 0 


Directive category: Simplified segment control 
Syntax: 

C'CESEG ( nave] 
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Description: This directive is the same as the . COOE directive, but is meant to be used 
in ideal mode only. COOESEG is used to inform the assembler that the information 
immediately following should be placed in the code segment. You must use the 
.MODEL directive before using COOESEG. 

If you are using the medium, large, or huge memory model, you can use an 
optional name with COOESEG; otherwise the name Is ignored. If you do not provide a 
name, the assembler creates one automatically from the module name. Later, the 
linker uses this name to concatenate and order segments 


COMM: Define a Communal Variable 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 31. MASM 6.0, 
TASM 2.0, TASM 3-0 

Directive category: Scope and visibility 

Syntax: 


COMM vardef ], vardef] ... 

where each vardef has the following construction. 

[language] [distance] laoel[[arraysize]]: type] -.count] 

Description: Communal .ariables are used for compatibility with some high level 
languages. They are similar in nature to external variables declared with EXTERN 
but. once set. they cannot be changed. Because the memory space for communal 
variables is not assigned until the executable file is loaded, using them can reduce 
the file size of your programs. — - 

In each variable definition, the language can be one of the following, depend¬ 
ing on your assembler: 


Language 

BASIC 

C 

CPP 

FORTRAN 

NOLANGUAGE 

Pascal 

Prolog 

STD CALL 

SYS CALL 


MASM TASM 

X x 

x X 

X 

X X 

X 

X x 

X 
X 
X 
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The distance can be either NEAR or FAR, and the type can be one of the 
standard data sizes such as BYTE. WORD, or DWORD. 


COMMENT: Define the Stan of a Comment Block 

!emblerS: Mtoosoft Quick Assembler 2 51. MASM 5.1, MASM 6 0, 
lAoM ^.0, TASM 3 0 

Directive category: Miscellaneous 

Syntax: 

COMMENT char 

Description: This directive is invaluable for use in defining comment blocks in 
.n th.rzr 15 U extensiv<:, > a ' ,he of «ch assembly language program 

The char ,s the character the assembler will use to define the limits of the 

beginning and end of the comment block. The assembler ignores evervthine 

between char and the second occurrence of char, treating them as comments It is 
important to use n rhonnor iknr „,:ii _i_ _ * . s Lummcnts. It is 


Example: 

Comment J 

File: 

CEX1.ASM 

Author: 

Allen L. Wyatt 

Oate: 

8/26/91 

Purpose: 

Subroutine designed to turn the cursor 

Format: 

curon() 


curoff() 


I 

I 


%CONDS: List All Conditional Statements 

Applicable assemblers: TASM 2.0. TASM 3.0 
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Directive category: Listing control 
Syntax: 

HCONDS 

Description: Instructs the assembler to include all conditional code in the listing 
file, whether it is included in the OBJ file or not. This directive is the same as the 
• LFCOND directive. 

.CONST: Define Beginning of Constant Data 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, MASM 6.0, 
TASM 2 0. TASM 3 0 

Directive category: Simplified” segment control 

Syntax: 

s * 

.CONST 

Description: This is one of several available simplified data-segment directives The 
others include .data. .data?. .FARDATA, and .FARDATA?. If you are using TASM. you 
can also use CONST. DATASF.G, and FARDATA. 

This directive is used to delineate data that will not change dunng program 
execution. It is not a necessary segment in stand alone programs, but may be 
necessary for compatibility with some high-level languages. 

(l. v 

t ' -_1 ^ • 

CONST: Define Beginning of Constant Data 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Simplified segment control 
Syntax: 

CONST 

Description: This is one of several available simplified data-segment directives. The 
Others include .CONST, .DATA, .DATA?, DATASEG, .FARDATA, . FARDATA?. and FARDATA. 

This directive is used to delineate data that will not change during program 
execution. It is not a necessary segment in stand-alone programs, but may be 
necessary for compatibility with some high-level languages. 
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-3. sT " — 


.CONTINUE: Modify Execution of a .REPEAT or WHILE 
Loop 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

.CONTINUE |.IF condition] 

Description: When you are using the .REPEAT or .WHILE directives to control 
program flow, you can use the . CONTINUE directive to modify how program execution 
occurs in the loop. This directive is another example of the way in which MASM is 
mutating toward high-level language coding and constructs. In this case, .CONTINUE 
functions in the same way as the CONTINUE statement in C. It causes program control 
to be transferred to the end of the loop. 

The condition used by the loop must resolve to either true or false It can be 

complex in nature (testing for two or more conditions), and may contain any of the 
following operators: 


Operator Meaning 


> 

> = 
< 

< = 
& 

&& 


Equal 
Not equal 
Greater than 
Greater than or equal to 
Less than 

Less than or equal to 
Bit test 
Logical AND 
Logical OR 
Logical NOT 


You can also test automatically the condition of flags bv mine t k * 
specialized flag-name operators: * s,n 8 the followj 


mg 
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Operator 


Sample Use 

CARRY? 


•CONTINUE .IF (CARRY?) 

OVERFLOW? 

.CONTINUE .IF (OVERFLOW?) 

PARITY? 


.CONTINUE .IF (PARITY?) 

SIGN? 


.CONTINUE .IF (SIGN?) 

ZERO? 


•CONTINUE .IF (ZERO?) 

Example: 


• 

MOV 

AL,0 

'.Start out with clean slate 

MOV 

CX,0 

;Got no characters so far 

.WHILE 

(AL ! = 

13) ;Keep going until Enter is pressed 

MOV 

AH,7 

jDirect character input without echo 

I NT 

2lh 

;D0S services 

.BREAK 

.IF AL 

== 27 ;Jump out if Esc was pressed 

.CONTINUE 

•IF (AL 

•0 ) ;; (AL > '9') ;0nly want digits 

PUSH 

AX 

;Save character for later 

MOV 

DL.AL 

;Get ready to output character 

MOV 

AH,2 

;0utput character 

I NT 

21h 

;00S services 

INC 

CX 

jCharacter count 

.BREAK 

.IF CX 

»» 4 ;0nly get up to 4 characters 

.ENOW 





.CREF: Enable Cross-Referencing 

Applicable assemblers: MASM 51. MASM 6.0, TASM 2.0, TASM 3-0 
Directive category: Listing control 
Syntax: 

.CREF 

Description: This is the default condition for listing files generated by the assem¬ 
bler It results in cross-reference information being generated and included at the 
end of the listing file. If the .NOCREF or HXCREF directives were in effect, cross- 
referencing information is included only from the line In which .CREF is encoun¬ 
tered. 

When used with TASM. this directive also causes an XRF (cross-reference) file 
to be generated. 
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%CREF: Enable Cross-Referencing 


Applicable assemblers: TASM 2 0, TASM 3 0 
Directive category: Listing control 
Syntax: 

%CREF 

Description: This is the default condition for listing files generated by the assem¬ 
bler It results in cross-reference information being generated and included at the 
end of the listing file. If the VJOCREF. .NOCREF, .XCREF, or \XCREF directives were in 
effect, cross-referencing information is included only from the line in which .CREF 
is encountered. 

This directive also causes an XRF (cross-reference) file to be generated. 


96CREFAJLL: Cross-Reference All Variables 

Applicable assemblers: TASM 2.0. TASM 3.0 
Directive category: Listing control 
Syntxx: 

%CREFAll 

Description: This is the default condition for listing files created with TASM. It 
results in cross-referencing all referenced and unreferenced variables, assuming that 
general cross-referencing has been enabled This directive undoes the effect of the 
*CREFREF and %CREFUREF directives. 



%CREFREF: Cross-Reference Only Referenced Variables 

Applicable assemblers: TASM 2 0, TASM 3 0 
Directive category: Listing control 
Syntax; 

'tCREFREF 
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Description; After this directive i*> processed, only variables that are referenced as 
operands arc listed in the cross-reference part of the listing file and in the XRF file. 
Normally, all variables (referenced and unreferenced) are included This directive is 
used if you don't want the cross-reference to be cluttered by variables that are 
defined but never referenced 

The SCREFAlL directive undoes the effects o( HCREFRCF. 


%CREFUREh Cross-Reference Only Unreferenced 
Variables 

Applicable assemblers; TASM 2.0. TASM .VO 
Directive category: Listing control 
Syntax; 

SCREFUREF 

Description: After this directive Is processed, only variables that are defined but not 
referenced are included in the cross-reference pan of the listing file and in the XW 
file. Normally, all variables (referenced and unreferenced) an. included. 

The SCREFall directive undoes the effects of ^CREFUREF. 


%CTLS: Include Listing-Control Directives in the 
Listing File Vr 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: Listing control 
Syntax: 

*CT13 

Description. Normally. TASM does not include listing-control directives in a 
senemied listing file. This directive causes these tvpcs of directives to be included 
Since the change takes place after this directive Is executed, the line including this 

directive never appears in • listing file 
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.DATA: Define Beginning of Data Segment 

Applicable assemblers! Microsoft Quick Assembler 2 51, MASM 5.1, MASM 6 0 
TASM 2.0, TASM 3 0 

Directive category: Simplified segment control 

Syntaxi 

.DATA 

Description: This is one of several available simplify data-segment directives. The 
others Include .const, .data?, .fardata, and .fardata?. If you are using TASM, you 
can abo use const, datasio, fardata, uoataseq, and ufaroata. 

Thu II a simplified segment directive used to Inform the assembler that the 

n :r , zrr' dij ,' dy / o "-''*‘ huuid bc p"*** •» »-««gmen, y ou 

use the .model directive before using .data, 

If you are using TASM, this directive is the same as the dataseg directive 


.DATA?: Define Beginning of Uninitialised Data Segment 

Applicable assembler*! Microsoft Quick Assembler 2 ai iuacu * , , 

TASM 2 0. TASM 3 0 ™ * 2.5|, MASM 5.1, MASM 6 0, 


Directive category! Simplified segment control 
Syntax i 


.DATA? 


Description: This is one of several available simplified dataseamen, hi. 
others include .const, .data, .fa-idat*. and .^oata, ff youTc " in^«M 
can also use const, oataseo, fardata, uoataseq, an d ufaroata. 8 rA5M| you 

This is a simplified segment directive used to inform the assemKu u 
information immediately following should be placed in a special urn V l * le 
segment. You must use the MOOEL directive before using .data; mnll,aJ «ed data 

it is not necessary to use this special type of segment, but vou m 

it to group your data. Such grouping may help you better undersianH^iT^ 0 USe 
parts of your program. ianu me different 

If you arc using TASM. this directive is the same u the uoatamo directive. 
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DATASEG: Define Beginning of Data Segment 

Applicable assemblers! TASM 2.0, TASM 3 0 
Directive category! Simplified segment control 
Syntaxi 

OATAIIO 

Description! This Is one of several simplified d»ta*segmem directives available . The 
others Include , const, conit, .oata, ,oata7, .pardata, ,paroata7,faroata, uoataho. 
and uparoata, This directive is the same as the .data directive, but Is designed to be 

used In ideal mode only. 

This Is a simplified segment directive used to Inform the assembler that the 
information Immediately following should be placed in the data segment. You must 
use the .model or mooel directives before using oat Alia. 


DB: Allocate a Byte of Storage Space 

Applicable assemblers! Microsoft Quick Assembler 2 51, MASM 5.1. MASM 6.0, 

TASM 2.0, TASM 3.0 

Directive category! Data allocation 

ftyntoxi 

1 label 1 01 tMpntiionl, injrtnion] _ 

rw„.jThu directive Is used to allocate memory in the executable file for 

to the nored Information. Each ..praiawn muat be one of the following. 

□ A number between -128 end 2 J5 
Q A formula reaoMng 10 a number between -128 and 2» 

Q Text characters 

_ . ro ho id ipacc but not Initialize the data area) 

O A question mark (used to noio 

.... the niip operator to specify multiple occurrences or 

In addition, you can use the uur op 

the daw In the expression. 

If the data located hr * *" * *'"* " 

refers only to the first byte of the 
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If you are using MASM 6.0, this directive is equivalent to the BYTE directive. If 
you are working explicitly with signed data, you can use the sbyte directive also. 

Example#: 


VaUdKeys 

0B 

.’YyNy’ 

ULCol 

DB 

00 

BoxSlzt Vv 

CO 

5 • 7 

Buffer 

08 

2048 0UP(7) 

Stack 

DB 

128 DUP(’STACK 


•) 


DD: Allocate a Doubleword of Storage Space 

M|C, “' >,, Quick A> “ mblcr MASM 5.1. MASM 6.0, 

< 

Directive category: Data allocation 
Syntax: 

[labil J DO 9Mpr9ssxon[ , 9xpr99sion) 

Description: This directive is used to allocate four bvtes of memory fa doui i» 
* ord) for data storage in the executable file. The ia&c i is a user defin?H ^ C * 

can use later to refer symbolically to the stored information. Each ex or., y ° U 

be one of the following: ^ •••ion must 

□ A number between -2,147,483,648 and -» 291 , 967,295 

□ A formula resolving to a number between -2 14* .»m A ,u 1 

' 4.294,967,293 1 -.w^.O-lBind 

□ A 32-bit floating-point number between ±U8 x io ,# * and ± 3.40 x io 58 * 

□ A far address pointer (segment and offset) 

□ A question mark (used to hold.space but not initiate the data area) 

in addition, you can use the Dl'P operator to specify mulrinU „ 
the data in the expression. P c occurrences of 

If the data allocated by the 0D directive is longer than a sinoi.. -j , , 

) abal refers only to the first doubleword of the allocated data^ ^ dou kleword, die 

If you are using MASM 6 0. this directive is equivalent >. 

^ou can also use the REA14 directive for floating-point numbers^ ° WOf,D dirccliv c. 
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Examples: 



FerAddress 

00 

Routine 

Values 

DD 

2.343, 50.682 

Countar 

00 

a 

MemArea 

00 

1024 • 64 * 4 

Array 

00 

12 0UP(?) 


%DEPTH: Set Listing-File Depth-Field Width 

Applicable assemblers: TASM 2 0. TA5M 3 0 
Directive category! Listing control 
Syntax: 

SDEPTH width 

Description: When you ha* e requested a listing file (L$T file) during assembly, this 
directive controls the width of U,e depth held This field is used as an indent when 
INCLUDE files and macros are expanded The default value is 1 character wide, b j 
you can set It to any reasonable value. 


DF: Allocate 6 Bytes of Storage Space 

Applicable assembler,: MASM S.l, MASM 6.0. TASM 2 0. TASM 3 0 
Directive category: Data allocation 

4 

Syntax: 

l label) OF »Kpr«saion[, oxpration] 

r, _A . TV. Uirrtive is used to allocate 6 bytes of memory for data st jr. gr 
Description: ‘ ^ ^ dlta llte „ used for 48-blt far pointer. In the 

I the executable filcTyp ^ I|b#x i# a userK i c flned name you can use later to 

«ftr ^ficall"io die .tored Information. Each...ion must be one of the 

following 

□ A number between -140,737,488,353,528 and 281.474.976,710.655 

□ A formula resolving to . number between -U0,737.4B8.355.J28 and 

281, 474, 976,T10,655 
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□ A 48-blt far address pointer (segment and 32*bit offset) 

□ A question mark (used to hold space but not Inltlallae the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the of directive Is longer than six bytes, the label 
refers only to the first six bytes of the allocated data. 

If you are using MASM 6.0, this directive is equivalent to the FVYOAO directive. For 
some assembler versions, this directive is equivalent to the OF directive. 

Fxamplesi 


ParAddress 

OF 

FOutins 

Vaiuss 

OF 

3.846, 60.612 

Countsr 

DF 

0 

MsnArsi 

OF 

1024 • 64 • 4 

Array 

DF 

12 DUP(?) 


DISPLAY: Output a String to the Screen 

Applicable assemblers! TASM 2.0, TASM 3.0 
Directive category! Miscellaneous 
Syntaxi 
DISPLAY * ts*f“ 

Description! This directive is used to display a text itHn* ,u 

during aaeembly li don ,.ot mull In any code belna M'nenVf' l' 1 '*!! 0 monl,of 
memory In the generated lie. * * en * ra " d ' nor d <*‘ It Uke 

The airing to be dlap.ayed, taut, muat be endoaed In ouoi.om. 

ute this directive to old In debugging, to that you can an limed late J* 1 ?*' V °“ 
conditional buinieiloiu are being oaeembled immediately when certain 

Similar function are provided by the ICHO and Mur directive,. 

Example i 


DISPLAY 'Now adding dtbug ruu inss* 
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.DOSSEG: Order Segments In Microsoft 
High-Level-Language Order 

Applicable assemblers! MASM 6.0 
Directive category: Complete segment control 


Syntax: 

.DOSSEQ 

Description: This directive causes the linker to order segment. In » 
manner defined by Microsoft high-level languages. The dl " ctlve ^^ e ^ 

stand-alone programs, and then only In the main module. This direct . 
introduced with MASM 6.0 so that the Instruction would be more consistent 
syntax of the .alpha and .8EQ directives. 

This directive orders segments as follows; 

1. Code segments with the class name CODE. 

2. All other code segments. 

3. Data segments with the class name BEGDATA. 

4. All other data oegmenu except those with the da.. name. BSS or STlWIfc^ 
3. Data segments with the class name BSS. 

6. Data segments with the class name STACK. # 

You can al.o affect the orderingo( segment, with the .alpha, acsha, .MO.Mtd 
beq directives. 

Thl» directive Is equivalent to the oobbeO directive. 


DOSSEG: Order Segments In Microsoft 
Hlgh-Level-Language Order 

Ap^Ucable ...emblem. Mlcrowll Quick Anembler 2.11, MASM 1.1. MASM «. . 
TASM 2.0, TASM 3 0 

Directive categoryi Complete segment control 


Syntax: 

DOSSEQ 
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1’an l\ 


Kckrtnc 


e 



Description. This directive emms the linker to order segments In 3 structured 
"•..inner dclined hy Microsoft high-level languages. It IS typically used in stand-alone 
1 rogi ams. and then only in the main module. 

Th)S directive orders segments as follows: 

1 Code segments with the class name CODE. 

i. All other code segments. 

3. Daa segments with the class name BECDATA. 

•4 All ether data segments except t‘ se with the class names BSS or STACK. 

5. Data segments with the class name BSS. 

6 . Data segments with the class name STACK. 

You can also affect the ordering of segments with the .alpha, alpha, .seq, and 

&EQ directives 

Iff "W'll M T M— 

DP: Allocate 6 Bytes of Storage Space 

Applicable assemblers: MASM 5.1. TA5M 2.0, TASM 3.0 

Directive cutcgory: Data allocation 

Syntax: 

\lab9l\ 0*-’ expression ], expression] 

Description: This directive Is equivalent to the OP directive. It Is u<ed to allocate 
6 byres of memory hr data storage In the executable file. Typically this data size is 
used for 48-bit far pointers in the 80386 or 80486 environment.' The is a 
user-defined name you can ufe later to refer symbolically to the stored Information* 
Each tspreision must be one of the following: 

Q A number between -NO,’’3"’.488 355.328 and 281.474,976,710,653 

□ A formula resolving to a number between -140,73?,488.^55 328 and 
281.-T4.9-6,710.653 

3 A in nit fai address polin segment and 32-bit offset) 

3 \ qi'-vsi'ori mx'k fused to hu..l space but no: Inmali/r the da # a i.rea) 

in addition, you cun use 'he D(‘ p operator to specifv multiple occurrences of 

the data in the expression 

if the luu allocated bv the directive is longer than sL\b>tcs the latiui refers 
only to the Itisc six bytes of the allocated data 
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This directive is not available with MASM 6 0; you should use FWORD or of 


instead. 



Examples: 


- 

FarAddress 

DP 

Routine * 

Values 

QP 

2.345, 59.682 

Countar 

DP 

0 

MtmArea 

OP 

1024 • 64 * 4 

Array 

OP 

12 0UP(7) 


DQ: Allocate a Quadword of Storage Space 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0.TASM 3.0 •__^- 

Directive category: Data allocation 

Syntax: 

[laosl] DQ »xpr$s$ion [, « xprestion) 

Description: This directive is used to allocate 8 bytes of memory (a quadword) for 
data storage In the executable file. Typically, this data size is used for 8-byte Integers 
used with numeric coprocessors. The lsbsl is a user-defined name you can use later 
to refer symbolically to the stored information. Each sxprtssion must be one of the 
following: 

Q A number between -2 6i and 2 U -1 

Q A formula resolving to a number between -2 6J and 2*M 

Q A 64-bit floating-point number between ±2.23 * 10and H.T9 ' 10*°* 

□ A question mark (used to hold space but not Initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data In the expression. 

If the data allocated by the DQ directive is longer than a single quadword, the 
label refers only to the first quadword of the allocated data. 

If you are using MASM 6.0, this directive Is equivalent to the OWORD directive. You 
can use the reals directive also for floating-point numbers. 
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Examples! 


^ • -v- 


. ^ 

Vsiusi 

DQ 

12346.6760, 067.6643 


* 

MsmArsi 

DO 

1024 • 64 • 4 



Array 

0Q 

12 0UP(7) 




DT: Allocate 10 Bytes of Storage Space 

Applicable assemblers! Microsoft Quick Assembler 2.31, MASM 3.1, MASM 6.0, 
TASM 2.0. TA5M 3.0 

Directive category! Data allocation 

Syntaxi 


Urtai] DT iMpmaont , upr»B»ion) 

Description! This directive Is used to allocate 10 bytes of memory for data storage 
In the executable file. Typically, this data size Is used for 10-byte Integers or real- 
number formats used with numeric coprocessors. The label Is a user-defined name 
you can use later to refer symbolically to the stored Information. Each expression 
must be one of the following: 


□ A number between -2** and 2*°-l 

Q A formula resolving to a number between -a" 9 and 2 M -1 

□ A packed decimal number between 0 and 10 10 -1 

a An 80-blt temporary floating-point number between ±3.37 x lO* 9 ** and 
±1.18 x 10 

Q A question mark fused to hold space but not initialise the data area) 

In addition, you * m use the DUP operator to specify multiple occurrences of 
the data in the expres' .on. 


If the data allocated by the 0T directive is longer than 10 bytes 
to the first 10 bytes of the allocated data. 




If you are using MASM 6.0, this directive is equivalent to the Twoao directive You 

can also use the Malis directive for floating-point numbera. 


Examples! 


VSlUSS 

DT 

12346.1710, 0S7.S843 

MsfiiArsa 

0T 

1S24 • 64 • 4 

Array 

0T 

12 DUP(T) 
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DW: Allocate a Word of Storage Space 

Applicable assembler*! Microsoft Quick Assembler 2.91, MASM 9 1, MASM 6.0, 
TASM 2.0, TASM 3 0 


Directive category: Data allocation 


Syntaxt 

(imij DW $Hpr§»Hon[, »xpresslon] 

Description: Thl* directive Is used to allocate 2 bytes of memory (a word) for data 
storage In the executable file. The lsbsl Is a user-defined name you can use later to 
refer symbolically to the stored Information. Each SKpression must be one of the 
following: 


□ A number between -32,76 7 and 69,939 

□ A formula resolving to a number between -32.76 7 and 69,939 

□ An offset for an address pointer 
3 A segment for an address pointer 

Q A question mark (used to hold space but not Initialise the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data In the expression. 


If the data allocated by the ow directive Is longer than a single word, the lsbsl 
refers only to the first word of the allocated data, 

If you are using MASM 6.0, this directive is equivalent to the word directive If 
you are working exclusively with signed data, you can use the 1*0*0 directive. 


Examples: 

Addrttsl 

Address! 

Addrsssa 

Counter 

lorssnlus 

Array 


DW 

Routine 

jAddreeel conteine only tne offset 

DW 

OMHT Routine 

jAddrsssl conteine only the offset 

DW 

IC0MINT Routine 

iAddresll conteine only tno segment 

DW 

• 


DW 

IS * II 


Ml 

11 DUR(t) 
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DWORD: Allocate a Doubleword of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

(iatosi) Oworo txpr»asion[ , utprasslcn] 

Description: This directive is equivalent to the DO directive. If Is used to allocate -4 
bytes of memory (a doubleword) for data storage in the executable file. The labal 
is a user-defined name you can use later to refer symbolically to the stored 
Information. Each axprasnon must be one of the following: 

□ A number between -2,147,*83.648 and 4.294,967,295 

□ A formula resolving to a number between -2,1*4"’ 483 648 and 
4.294,967,295 

J A 32-bit floating-point number between ±1.18 x 10 JM and ±3 *0 x 10 w 

□ A far address pointer (segm-u and offset) 

3 A question mark (used to hud space but not initialize the data area) 

the Juf„t^o"n USe DLP ° Pmt0r ‘ of 

If the data allocated by the OBD directive I, longer than a smglc doubleword 
the label refers only to the tbs' uoubleword of the allocated dauc d ' 

If you are working exclusively with algned numbers, you can use the aowoan 
directive. You can use the R»u directive also for floating-point numben 

Examplesi 


FarAddrtss 

owono 

noui.' • 

Valuta 

DWORD 

2 .1,062 

Countar 

DWORD 

0 

MamAraa 

OWORO 

10-M ‘ 64 * 4 

Array 

DWORD 

I? *"f?) 

* 

rxrj 

; .rj 


ECHO: Output 2 9 ring to rhe Screen 

AppUcabl «a6cmoli!rt. 6.0 

Directive uAtegorv: ,/C lsc«.‘'aneoui 
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Syntax: 

ECHO text 

Description: Thl<* directive is used to display a text string to the video monitor 
during assembly. It does not result in any code being generated, nor does it take 
memory in the generated file 

You can use this directive to aid in debugging, so that you can see immediately 
when certain conditional instructions are being assembled. The OISPIAV and NOUT 
directives provide similar functions. 

Example: 

ECHO Now adding debug routines 


.ELSE: Conditional Program Execution 

Applicable assemblers: MASM 6.0 
Directive categoryi Control flow 
Syntax: 

.ELSE 

Description! This directive, In conjunction with the . IP and • End IF directives, can 
be used In assembly language programs to provide the some functionality as their 
counterparts In high-level languages. 

Example: 


QttKsy: mov M,r 


THT 21h 


;Direct charaottr input without toho 
; DOS aarvieM 



'•') l! (Al «• 'a*> 

;Convert to uppereaaa 


and AL.OSFh 


. ENDIF 



W BX, OFFSET OetKey 


iAddraaa of exit routine 


;Addraee warn prograa atari 


sAddraaa of flit oparationa 


;Baginnii 


i 


i 


.ENOIF 


;Jump to right routine 


jup 1®*1 
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ELSE: Conditional Assembly 

Applicable assemblers) Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6 0. 
TASM 2.0, TASM 3.0 

Dlrcttylve category: Conditional assembly 
Syntaxi 

llll 

Description) This directive, in conjunction with the IP. ILIIJP. and INDIP direc- 
lives, can be used in assembly language programs to control which portions of the 
code are assembled. 

The Instructions immediately following the Bill directive, up to the 
endip directive, are executed if the expression used in the original IP directive is false. 
Any preceding elseip directives must also evaluate as false for the instructions 
following the else directive to be executed. 


Example) 


DtmoCount 0W 
IF 

DtmeMestage Dl 

ILIEIP 

DemoMocaagt Dl 

ELSE 


S 

Demo 10 1 

•This is ■ bere-bonee Seine version ef the program', 
Demo E0 3 

•This is e deluse demo version of the program', • 


HOUT Demo veiue ie not ett cerreetXy 


INOIP 




HLSEIF: Conditional Program Execution 

Application aaeemblersi MASM 6.0 
Directive category: Control flow 


Syntaxi 

.BLSEIP oondition 

Description) This directive, in conjunction with the . IP and . KNOIP directives, can 
be used in assembly language programs to proride the same functionality as their 
counterparts in high-level languages. 
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The cone it ion used by the . ELSE 1F directive must resolve tq either true or false. 
It can be complex (testing for two or more conditions) and may contain any of the 
following operators: 


Operator 


l* 

> 

>• 

< 

<■ 

& 

&& 

I! 

i 


Meaning 

Equal 
Not equal 
Greater than 
Greater than or equal to 
Less than 

Less than or equal to 
Bit test 
Logical AND 
Logical OR 
Logical NOT 


You can also test automatically the condition of flags by using the following 
specialised flag-name operator*! 


Operator Sample Ute 


CARRY? 

OVERFLOW? 

PARITY? 

SIGN? 

ZERO? 


.BREAK .IF (CARRY7) 
.BREAK .IF (OVERFLOW?) 
.BREAK .IF (RARITY?) 
.BREAK .IF (IION?) 
.BREAK .IF (ZERO?) 


Exaroplci 


MOV 

AH,7 

INT 

81h 

.IF 

(AL M ’*') !1 (AL «' 

AND 

AL.SSFh 

.ENOIP 


.IF 

AL 'X' 

MOV 

•X, OFFOIT Isit 

.ELBIIF 

AL • 

MOV 

Bx, OFFSET Beginning 

.ILBC1F 

AL •• 

MOV 

BX. OFFSET FiloOpS 


iDirect character input without eoho 
;DOS ssrvioss 

'*’) 

iConvsrt to uppsreass 


(Address of amt routine 
(Address warm program start 
jAddrsss of fils operations 


Scanned with CamScanner 









912 Part IV: Reference 


.ELSE 

MOV BX, OFFSET OetKey ;8eginning of this routine 

.ENOIF 

JMP tBX1 ' ;Jump to right routine 



ELSEIF: Conditional Assembly 

AppUc«blc assemblers: Microsoft Quick Assembler 2.51, MASM 6.0, TASM 2.0, 
TASM 3.0 

Directive category: Conditional assembly 
Syntax: 

ELSEIF txprtnion 

Description: This directive, in conjunction with the IF and ENOIF directives, can be 
used In assembly language programs to control which portions of the code are 
assembled. 

The conditional expression must evaluate io true for the following code to be 
assembled. If the expression is not true, assembly contir.ues at the next ELSEIF, ELSE, 
or ENOIF directive. 


Example: 

OemoCount Dw 

IF 

DemoMesssge 00 


0 


Demo EQ 1 

'This is a btre-bonee demo version of the program' o 
ELSEIF Demo EQ 2 

OemoMeeaage OB 'This le a deluxe demo version of the program' Q 

ELSE ' 

%0UT Demo value ia not set correctly 

ENOIF 



EMUL: Use Floating-Point Emulation 


Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category! Global control 


Syntax: 

EMUL 


Scanned with CamScanner 








Chapter 2.V Assembler Directives 


913 


Description: Normally, TASM assumes that you have some surt of numeric 
coprocessor present in your system. This means that during assembly the assembler 
generates code that can take advantage of the coprocessor. 1/ you include this 
direcuve, TASM assumes that you have installed an emulation package which will 
provide the higher-level math functions normal!) provided by the NPX 



END: Designate Source-File End 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5 1. MAsM o 0 
T/\SM 2.0, TASM 3 0 

Directive category: Complete segment control 
Syntax: 

END | address] 

Description: This directive is designed to be the last statement in vour source lile. 
It lets the assembler know that the end of the file has been reached and assembly 
should stop. 

Optionally, you can include an address that designates the address at which 
you want execution to begin in the program, this address typically is in the form of 
a label previously assigned to the beginning of the main routine. 

.ENDIF: Conditional Program Execution ^ 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

•ENDIF 

Description: This directive, in conjunction with the .IF directive, can be used in 
assembly language programs to provide the same functionality as their counterparts 
in high-level languages. 
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Example: 


T •• * 



GetKey: 

MOV 

AH, 7 

;Direct character input without echo 



INT 

21h 

;D0S services 

• 

- 

• IF * - 

(AL >= ‘a *) ;; (AL <= 

•z) 



AND 

.ENDIF 

AL,05Fh 

* 

;Convert to uppercase 

• 


.IF 

> 

f” 

II 

II 

X 




BX, OFFSET Exit 

;Address of exit routine 



.ELSEIF 

CD 

II 

II 

—1 

< 




MOV 

BX, OFFSET Beginning 

;Address warm program start 

* 


.ELSEIF 

AL =* 'F‘ 

. 



MOV 

BX, OFFSET FileOpS 

;Address of file operations 



• ELSE 

Muv 

BX, OFFSET GetKey 

;Beginning of this routine 



.fcNOIF 

JMP 

(BX) 

;Jump to right routine 



ENDIF: Conditional Assembly 


Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5 1 MASM 6 0 
TASM 2.0, TASM 3 0 


Directive category*: Conditional assembly 


Syntax: 


ENDIF 


Description: This directive, in conjunction with a conditional assembly instruction, 
can be used in assembly language programs to control which portions of the code 
are assembled. The ENDIF directive is used to conclude a conditional assembly block 
begun with one of the following directives: 


IF 

IFDIFI 

IF1 

IFE 

IF2 

IF ION 

IFB 

IFIDNI 

IFDEF 

IFNB 

IFDIF 

IFNOEF 
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Example: 


OemoCount Ow 
IF 


0 

Demo CO 1 


DemoMessage DB 

ELSEIF 

DemoMessage DB 

ELSE 


‘This is a bare bones demo version c* the program , e 
Demo EO 2 

'This is a deluxe demo version of the program', 0 


AOUT Demo value is not set correctly 


ENDIF 


t ’ ' I ' m ? *-, 

ENDM: End a Macro or Loop 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5 1. MASM 6.0. 
TASM 2 0, TASM 3-0 

Directive category: Macros and repeat blocks 


Syntax: 

ENDM 

Description: ENDM can be used in several ways. In a general sense, it simply marks 
the end of a macro begun with the MACRO directive, or the end of a loop begun with 
the IRP, IRPC, or REPT directives. If you are using MASM 6.0, it also terminates loops 
started with the FOR, FORC, REPEAT, and while directives. 

m: nx ; x 1 m b 5 
ENDP. End a Procedure 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 51, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Procedures and code labels 
Syntax: 


[J3bel] ENDP 

or, if using TASM’s ideal mode. 


ENOP. [label] 

_ „ .1 __~ inf at which the assembler should consider the 

escription: « directive is used on the line immediately 

procedure closed. Generally, the enuk u 

following the RET instruction. 


Scanned with CamScanner 











Pan IV: Reference 


The optional label must match the procedure-name label used at the begin¬ 
ning of the procedure. 


ENDS: End a Segment cr Structure 

Applicable assemblers: Microsoft Quick Assembler 2 51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Complete segment control, complex data types 

Syntax: 

label ENDS 

or, if using TASM's ideal mode: 

ENDS [label] 

Description: Defines the point at which the assembler should consider a segment 
or structure closed If ENOS is closing a segment, that segment is one begun with the 
SEGMENT directive. If you are using simplified segment directives, the ENDS directive 

is not necessary. The label must match the segment-name label used at the 
beginning of the segment. 

When closing a structure or a union, ends is used to declare the end of a 
structure begun with the STRUC directive, or a union begun with the union directive. 
If you are using MASM 6.0, structures can also begin with the STRUCT directive The 
label must match the label used at the beginning of the structure or union. 



ENDW: End a .WHILE Loop 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

.ENDW 

Description: This directive is used to mark the end of a loop constructed with the 
while directive. These loops function the same as their counterparts in high-level 
languages. ^ 
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MOV AL,0 


I Start out with a ciean slate 
;Keep going until Enter is pressed 
iDirect character input without echo 
;DOS services 


.WHILE (AL !* 13) 


MOV AH, 7 

INT 21h 

.ENOW 



ENUM: Define Enumerated Data 


Applicable assemblers: TASM 3.0 
Directive category: Complex data types 


Syntax: 

~ a 

label ENUM (variable l , variable] ... J 
or, if using ideal mode: 

ENUM label (variable!, variable] ...) 
where each variable has the construction 
varlabel {= value] 

Description: Enumerated data types have long been used by high-level language 
programmers. The ENUM directive allows you to define enumerated data, which is 
simply a group of values stored in a nonstandard number of bits. The largest value 
stored determines how many bits are used. 

The label is the symbolic name you want to assign to the data type, and 
varlabel is the name of each variable in the data type. Optionally, you can assign a 
value to each varlabel. 

tf you find your enumerated data definitions becoming quite large, you can 
use the multiline version of this directive, which simply requires that you place a 
left brace ({) on the same line as the ENUM directive. Everything encountered up to 
a right brace (}) is considered part of the definition. 


EQU: Assign a Constant Value to a Label 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 
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Directive category: Miscellaneous 
Syntax: 

label EQU expression 

Description: This directive is used to assign a constant value to a user-designated 
label. EQU is similar in purpose and function to the equal-sign directive (=). Using the 
EQU directive does not result in storage space (memory area) being assigned in a 
program; it just assigns a value 10 a label. Then, later in the program, this label can 
be used in place of the value. Use of the EQU directive makes programs clearer and 
easier to maintain. 

The expression to the right of the EQU directive must be equivalent, in some 
way. to an integer value. It can be a number, a formula that can be resolved to a 
number, up to four text characters (whatever can be stored in a register or extended 
register on the processor), or an address 

The difference between the EQU directive and the - equal sign is that values 
defined with EQ’J are constant, whereas values defined with the equal sign can be 
changed in a program. 

Examples: 

Mono EQU 050000 

Color EQU 05800b 

MaxRows EQU 2S • 80 

Affirmative EQU ‘Y‘ 

TableStart ' EQU THIS BYTE 

i i> 

.... r 

flP' * TiilWI HI M 

.ERR: Force an Error To Occur 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0, 

TASM 2.0, TASM 3 0 

Directive category: Conditional error 

Syntax: 

=RR [<message>] - 

Description: Whenever this directive is encountered, the assembler generates 
an error Typically. . ER« * used inside conditional assembly blocks, in conjunction 
with the DISPLAY. ECHO, or %0UT directives, to signify that a certain type of assembly 
has occurred. Uyo* are using MASM 6 0. vou can include an optional error message, 
enclosed in angle brackets «>). after the -ERR directive. This message will be 
ilhplayed when the error is generated 

If you are using TASM. you ta.i the err directive also 


;Mono video buffer start* 
;Color video buffer start 
jRegular screen size 
;Acceptable keypress 
•;Tat)le starts here 
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ERR: Force an Error To Occur 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Conditional error 
Syntax: 

ERR ' --' 

Description: This directive is the same as the . ERR directive. Whenever this directive 
is encountered, the assembler generates an error. Typically. ERR is used inside 
conditional assembly blocks, in conjunction with the DISPLAY, ECHO, orAOUT direc¬ 
tives, to signify that a certain type of assembly has occurred. 


ERR1: Force an Error To Occur on Assembler Pass 1 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. TASM 2.0, 
TASM 3 0 

Directive category: Conditional error 
Syntax: 

.ERR1 

Description: This directive is meaningful only in old versions of MASM (earlier than 
MASM 6.0) and if you are using TASM in multipass mode. MASM 6.0 is a single-pass 
assembler, as is TASM under normal circumstances. 

If this directive is used, it is treated essentially the same as the ERR directive. If 
you are using TASM, this directive is the same as the ERRIFi directive. 



.ERR2: Force an Error To Occur on Assembler Pass 2 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, TASM 2 0. 
TASM 3.0 

Directive category: Conditional error 
Syntax: 

.ERR2 
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Description This directive i* meaningful only in old versions of MASM (prior to 
MASM 6 0) and if\ou are usingTASM in multipass mode. MASM 6 0 is a single-pass 
assembler, as is 1 ASM under normal circumstances. 

Because this directive is obsolete, using it with the newer versions of the 
assemblers results in an error message being generated. TASM generates a warning 
message only if functioning in the default single-pass mode. 



.ERRB: Generate an Error If Argument Is Blank 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2 0. TASM 3 0 

Directive category: Conditional error 

Syntax: 

. ERR3 <argumenf >[, <message>] 

Description: In macro definitions, this directive is used to test whether an argument 
was passed to the macro. If one was not passed, an error is forced The label of the 
argument to be tested, argument, must be enclosed in angle brackets (<>). 

Ifyou are using MASM 6 0. you can include an optional error message, enclosed 
in angle brackets (<>), after the .ERR9 directive. This message will be displayed 
when the error is generated. 

If vou are using TASM, you can use the ERRIFB directive also to accomplish this 
same task 


Example: 

DOSCall MACRO Service 


;Need to nave a service argument 
;Load service m preper place 
;D0S interrupt 


.ERRB <Service> 
MOV AH,Service 

INT 2lh 

E'.DM 



.ERRDEF: Generate an Error If Symbol Is Defined 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 1 MASM 0 0 
TASM 2.0. TASM 3.0 

Directive category: Conditional error 
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Syntxv: 

.ERROEF Jaoell, <message>l 

Description: When >ou are working in a large program, remembering whether 
you already have generated symbols is difficult—particularly if you are using macros. 
If you already have defined label, an error is generated if this directive is 

encountered. 

Ifvou are using MASM 6.0. you can include an optional error mess age. enclosed 
in angle brackets (<>). after the .ERROEF directive. This message will be displayed 

when the error is generated. 

If you are using TASM. you can use the ERRIFDEF directive also to accomplish 
this same task. 


Example: 

DOSCall 

DOSInt 


MACRO Service 
.ERRB <Service> 
.ERROEF OOSlnt 
= 2ih 

MOV AH .Service 
INT DOSInt 
ENOM 


;Need to have a service argument 
;Should net hav£ been defined before 

;Load service in proper place 
;D0S interrupt 


.ERRDIF: Generate Error If Strings Are Different 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5.1. MASM 6.0. 
TASM 2.0. TASM 3 0 , ' ^ 

Directive category: Conditioibl error 

Syntax: 

.ERROIF <stringi> ,<stnng2>l, <message >1 

n * , «„• When vou are working with macros, being able to tell whether the 
Description: When you q ^ correcl is handy . This directive compares 

arguments being passco to they ^ dlfferen t. Both stringi and stnng2 

two strings and generates an and either one of them can be an argument 

must be enclosed mangle ’ andst ring2 have to match, character for 

name. .ERROIF is sensitive tocase-stn. « 

maSM 6 o vou can include an optional error message enclosed 
If you are using MASM o- .. direcuv e. This message will be displayed 

in angle brackets (<>)• ahcr wc * 
when the error is generate 


Scanned with CamScanner 








this sameLT US '" 8 ^ y °“ ‘ hC EflRIF0,F "*** «■» » accomplish 

Example: 


DOSCall MACAO Service 

.ERRDIF <Service>,< 3 > 
MOV ah,S ervice 

INT 2lh 

ENDM 


,'Only allow service 8 so far 
;load service in proper place 
;DOS interrupt 


.ERRDIFI: Generate Error If Strings Are Different 
(Case Insensitive) 

S‘“ imi MiCr ° 50ft QUlCk 2 '«• “*»• 5 >- MASM 6.0. 

Directive category: Conditional error 
Syntax: 

.ERRDIFI <stringl>,<string2>l, <message>] 

Description: This directive is essentially the same as .erroif, except that it is no, 
case-sensitive. - * • LC P C 11 is not 

When working with macros, being able to tel] whether the arguments bein. 
passed to the macro are correct is handy This directive compares wo strings -nd 
generates an error if they are different Both string, and stringE must be endowed 
■n angle brackets (< >). and either one of them can be an argument name 

Ify^u are using :V1ASM 6.0 you can include an optional error. e ,s,,, enclosed 

m angle brackets (<>). after the .errdifi directive. This message will bedbp aved 
when the error is generated atspiayed 

■his same “asT U5i " S ^ “ ‘ ht ' ERRIFD!FI » accomplish 

Example: 


PrtYy MACRO Char 

.ERRDIFI <Char>,<y> 
MOV AH,2 
MOV DL.Char 

INT 21h 

ENDM 


;0nly allow Y or y 
.Output character 
;Exact character passed 
;D0S interrupt 
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ERRE: Generate Error If False 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0. 
TASM 2.0, TASM 3 0 

Directive category: Conditional error 
Syntax: 

.ERRE expression , </nessage>] 

Description: This directive generates an error if the expression resolves to be false 
(0) If you are using MASM 6.0, you can include an optional error message, enc o 
in angle brackets (< >). after the directive. This message will be displayed when th 

error is generated. 

If you are using TASM, you can use the ERR I Ft directive instead of this one 
Example: 


DOSCall 


MACRO 

Service 

.ERRE 

Service 

MOV 

AH,Service 

TNT 

2ih 

EN0M 



;Error if argument is 0 
;Load service in proper place 
;D0S interrupt 


.ERRIDN: Generate Error If Strings Are Identical 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0, 

TASM 2.0, TASM 3-0 

Directive category: Conditional error 

Syntax: 

-ERRION <strrn„».<strin ( 2>l, <**«»*>! 

_ . . wh.n working with macros, being able to tell whether the arguments 
Description: When wo g directive compares two strings 

being passed to the macro arecotre ^ ^ you ^ cnsure that certain 

rnd generates an erio ' macro You sinop |y comp are a passed argument 

arguments are not use , de , nd d they are the same, this direedve will 

with the argument you want to exciu 

venerate an error. .„(<>), andeither 

tease—st ring i and 


generate an error. 

. cnrl string2 must be enclosed in angle brackets (<>). and either 

Bothstrino ortm rnent name. .ERRIDN is sensitive to case—stringi and 

me of them can be an for ch^cer 

»tring2 have to match, cnar 
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If you are using MASM 6 0. you can include an optional error message, enclosed 
in angle brackets (< >). after the .errion directive This message will be displayed 
when the error is generated. - 

If you are using TASM. you can use the ERRIFION directive instead of this one. 
Example: 

OOSCall MACRO Service 


.ERflION <$ervice>,<8> 

;Don't allow service 8 

MOV ah,S ervice 

;Load service in proper place 

INT 2lh 

;00S interrupt 

ENOM 





.ERRIDNI: Generate Error If Strings Are Identical 
(Case Insensitive) 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 1 MASM 6 0 
TASM 2 0. TASM 3.0 * 0 U * 

Directive category': Conditional error 

Syntax: 

.ERRIDNI <stringi>,<string2>[, <message>) 

Description: This directive is essentially the same as .erridn. except that it is case 
insensitive 

When working with macros, being able to tell whether the arguments bcine 
passed to the macro are correct is handy This directive compares tWo strings and 
generates an error if they are identical, except for case. Thus, vou can exclude certain 
arguments from working with your macro. Both stringi and string 2 must be 
enclosed in angle brackets (< >). and either one of them can be an argument name. 

If you are using MASM 6 0, you can include an optional error message enclosed 
in angle brackets (<>), after the .ERRIONI directive. This message will be displayed 
when the error is generated. v 7 

If you are using TASM. you can use the ERRIFIDNI directive instead of this one 
Example: 

DontPrtYy MACRO Char 

.ERRIDNI <Char>,<Y» ;Anything except Y or y 

MOV ah, 2 ;0utput character 
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MOV DL.Char 

INT 21h 

ENOM 


.Exact cnaracte~ passed 
;OOS interrupt 


ERR1F: Generate Error If True 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: Conditional error 
Syntax: 

ERRIF expression 

Description: This directive generates an error if the expression resolves to be true 
(non 0). ERRIF is the same as the .ERRNZ directive. 

Example: 


DOSCall 

MACRO 

Service 



ERRIF 

Service EQ 8 

;0o n ’t let work for service 8 


MCV 

Ah.Service 

;Load service in proper place 


INT 

ES0M 

2ih 

;D0S interrupt 

• 


ERRIF 1: Force an Error To Occur on Assembler Pass 1 

Applicable assemblers: TASM 2 0. TASM 3.0 
Directive category: Conditional error 
Syntax: 

ERRIF1 

Description: This directive is the same as the .ERRi directive. It is meaningful only 
if you are using TASM in multipass mode. If this directive is used, it is treated 

essentially the same as the ERR directive. 
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F.RRIF2: Force an Error To Occur on Assembler Pass 2 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: Conditional error 
Syntax: 

ERRIF2 

Description: This directive is the same as the . ERR2 directive. It is meaningful only 
if you are using TASM in multipass mode. If this directive is used when TASM is 
operating in a single-pass mode, it generates a warning message. 

ERRIFB: Generate an Error If Argument Is Blank 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: CondPinnal error 
Syntax: 

ERRIFB <argument> 

Description: This directive is the same as the .ERRB directive. Used in macro 
definitions, this directive tests whether an argument was passed to the macro If one 
was not passed, an error is forced. The label of the argument to be tested, argument 
must be enclosed in angle brackets (< >). 

.Need to have a service argument 
;Load service in proper place 
;D0S interrupt 


ERRIFDEF: Generate an Error If Symbol Is Defined 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Conditional error 
Syntax: 

ERRIFDEF label 


Example: 

DOSCall 


MACRO Service 
ERRIFB <Service> 
MOV AH.Service 
INT. 21h 
EN0M 
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Description: This directive is the same as the .ERRDEF directive When you are 
working in a large program, remembering whether you already have generated 
symbols is difficult—particularly if you are using macros. If you have already defined 


label and this directive is encountered, 
Example: 

* 

DOSCall MACRO Service 

ERRIFB <Service> 

ERRIFDEF DOSInt 
DOSInt = 21h 

MOV AH,Service 
INT DOSInt 

ENDM 


an error is generated. 


;Need to have a service argument 
;Should not have been defined before 

;Load service in proper place 
;D0S interrupt 


ERRIFDIF: Generate Error If Strings Are Different 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Conditional error 
Syntax: 

ERRIFDIF <stringl>,<string2> 

Description: This directive is the same as the . ERRDIF directive. When working with 
macros, being able to tell whether the arguments being passed to the macro are 
correct is handy. This directive compares two strings and generates an error if they 
are different. Both stringi and string2 must be enclosed in angle brackets (<>), 
and either one of them can be an argument name. ERRIFOIr is case-sensitive 
stringi and string2 have to match, character for character. 


Example: 

OOSCall MACRO Service 

ERRIFDIF <Service>,<8> 
MOV AH, Service 
INT 21h 
ENOM 


;0nly allow service 8 so far 
;Load service in proper place 
;D0S interrupt 


Scanned with CamScanner 







928 Part iv. Reference 


ERRIFDIF1: Generate Error If Strings Are Different 
(Case Insensitive) 

Applicable assemblers: TASM 2.0, TASM 3.0 

\ 

Directive category: Conditional error 
Syntax: 

ERRIFDIFI *string1>,*string2> 

Description: This directive is the same as the . ERRDIFI directive It is also essentially 
the same as the ERRIFDIF and . ERROIF directives, except that it is insensitive to case. 

When you work with macros, being able to tell whether the arguments being 
passed to the macro are correct is handy This directive compares two strings and 
generates an error it they arc different Both stringi and string2 must be enclosed 
in angle brackets (< >), and either one of them can be an argument name. 

Example: 


PrtYy 


MACRO Char 

ERRIFDIFI <Char>,<Y> 
MOV AH,2 

MOV 01.Char 

INT 21h 

ENOM 


;0nly allow Y or y 
;0utput character 
;Exact character passed 
;D0S interrupt 



ERR1FE: Generate Error If False 

Applicable assemblers: TASM 2.0, TASM 3.0 


Directive category: Conditional error 
Syntax: 


ERRIFE expression 

Description: This directive generates an error if die expression resolves 
(0). It is the same as the .frre directive. 


to be false 


Example: 


OOSCall MACRO Service 
ERRIFE Service 
MOV AH,Service 

INT 21h 

ENOM 


;Error if argument is 0 
;Load service in proper 
;DOS interrupt 


Place 
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ERRIFIDN: Generate Error If Strings Are Identical 

Applicable assemblers: TASM 2 0. TASM 3 0 

* 

Directive category: Conditional error 
Syntax: 

ERRIFIDN <Strlng1>,<string2> 

Description: This directive is the same as the .ERRIDN directive. When you are 
working with macros, being able to tell whether the arguments being passed to the 
macro are correct is handy. This directive compares tw-o strings and generates an 
error if they are the same. Thus, you can ensure that certain arguments are not used 
with your macro. You simply compare a passed argument with the argument you 
want to exclude, and if thei'are the same, this directive will generate an error. 

Both stringi and string2 must be enclosed in angle brackets (< >). and either 
one of them can be an argument name. ERRIFIDN is sensitive to case—stringi and 
string2 have to match, character for character. 

Example: 

CuSCall MACRO Service 

ERRIFION <Service>,<8> ;Oon‘t allow service 8 

MOV AH,Service ;Load service in proper place 

INT 2ih ;D0S interrupt 

ENDM 



ERRIFIDNI: Generate Error If Strings Are Identical 
(Case Insensitive) 

Applicable assemblers: TASM 2.0. TASM 3.0 
Directive category: Conditional error 
Syntax: 

ERRIFIDNI <stringi>,<string2> 

Description- This directive is the same as the . ERRIDNI directive. It is also essentially 
the same as the ERRIFIDN and .ERRION directives, except that it is insensitive to case. 

When vou are working with macros, being able to tell whether the arguments being 
passed to the macro are correct is handy. This directive compares two strings and 
generates an error if they are identical, except for case. Thus, you can ensure that 
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certain arguments are not used with your macro. You simply compare a passed 
argument with the argument you want to exclude, and if they are the same, this 
directive will generate an error. 


Both string i and string? must be enclosed in angle brackets (< >). and either 
one of them can be an argument name. 

Example: 

OontPrtYy MACRO Char 


ERRIFIDNI <Char>,<Y> * 

MOV AH,2 

MOV DL.Char 

INI 2lh 

ENDM 


;Anything except Y or y 
;0utput cnaractei 
,F*act charaerp- passed 
;D0S inter'* .ft 



I RJUFNB: Generate an Error If Argument Is Not Blank 

Applicable assemblers TAS.VI 2 0. TASM 3 0 
Directive category: Conditional error 
Syntax: 

FRRIFNB <argument> 

Description: This directive is the same as the .ERRNB directive Ir. macro definitions, 
this directive is used to test whether an argument was parsed to the macro. If one 
was passed, an error is forced. This is helpful in ensuring that the macro is used 
cot et ilv The label of the argument robe tested, argument, must be enclosed in angle 
brackets {<>). 

Example. 

DQSCe11 MACRO Service, Func 


FRRIFB *Service> 
FRRIFNB <Func> 
MOV ah,S ervice 

IN r 21h 

ENDM 


;Need to nave a service argument 
iCan't allow functions; haven't coded for y 4t 
;Load service in proper place 
;D0S interrupt 
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ERRIFNDEF. Generate an Error If Svmbol Is Not Defined 

Applicable assemblers- TaSM 2 0. IaSM 3 0 
Directive category- Cor. Jmunal error 
Syntax: 

ERnIFNOEF lacel 

Description: This directive is the same as the . ERRNDEF directive VXlicn vou are 
working in a large program, remembering whether you alread> have generated 
symbols is difficult— particularly if you are using macros If you have not already 
defined laDel and this directive is enountered. an error Is generated 


Example: 

ocscall 


MACRO Service 
ERR! F B <Se'v:ce> 
MOV A-.Se-vice 

ERRIrNCEF OOSint 
INT OOSint 

ENDM 


sees to nave a earvxce argument 
toad service in p'-ooer place 
Snculd have Deen Cefmed Defcre 
00 S interrupt 


ERRNB: Generate an Error If Argument b Not Blank 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 1. MASM o 
TASM 2.0. TASM 3 0 

Directive category: Conditional error 

Syntax: 

.ERRNB *trg u mtnt>[, 

Description: in macro definition,, this direct,ve is used to test whether an argument 
was passed to the macro. If one was passed an error „ forced. Thu u helpful ,n 

^ . ,,..h correctly The label of the argument to be tested, 
ensuring that the macro is used coitclu; 

argument, must be enclosed in angle brae 

. o vOU can include an optional error message, enclosed 

If you are using MASM 6Uyo Thu message will be displaved 

In angle brackets (<>). ^ er lhc EH 
when the error is generated. 
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If >ou are using TASM. you can use the E a ®:-N8 directive instead of this one. 
Example: 

DOSCail MACRO Service, Fgnc 


• ERRB <Service> 

.ERRhB *Func> 

MOV AH, Service 

1NT 21h 

ENOM 


;heed to nave a service argusent 
iCan't alio* functions; haven’t cooed for y* 
;load service in proper place 
;DO$ interrupt 


.ERRNDEF: Generate an Error If Symbol Is Not Defined 

Applicable assemblers: Microsoft Quick Assembler 2 51. MAS.M 5 1. MASM 6 0. 
TASM 2 0, TASM 3 0 

Directive category: Conditional error 

Syntax: 

.ERRf.OEF iaceJ(, <message>] 

Description: NXlicn you are working in a large program, remembering whether you 
already have generated symbols is difficult—particularly if you are using macros. If 

you have not already defined label and this directive is encountered, an error is 
generated 

if you are using MASM 6 0. you can include an optional erroraessage, enclosed 
m angle brackets (< >), after the .ERRNDEF directive. This message will be displayed 
when the error is generated 

If you are using TASM. you can use the ERRIFndef directive instead of this one. 
Example: 

DOSCall * MACRO Service 


.ERRS <Service> 
MOV AH.ServlC* 

.ERRNDEF COSInt 
INT OOSInt 

ENDM 


;Need to have a service argusent 
;Load eervice in proper place 
;Should have been defined before 
;D0S interrupt 
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.ERRNZ: Generate Error If True 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Conditional error 

Syntax: 

.ERRNZ expression , <messsge>) 

Description: This directive generates an error if the expression resolves to be true 
(non 0). If you are using MASM 6.0, you can include an optional error message, 
enclosed in angle brackets (< >), after the directive. This message will be displayed 
when the error is generated. 

j 

If you are using TASM, you can use the ERRIF directive instead of this one. 
Example: 

DOSCall MACRO Service 

.ERRNZ Service EQ 6 ;Don't let work for service 8 

MOV AH(Service ;Load service in proper place 

INT 21 h ;D0S interrupt 

EN0M 


EVEN: Adjust the Assembler Location Counter . 
to an Even Address 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Complex data types 
Syntax: 

EVEN 

Description: Using this directive is the same as using the align word or align 2 
directives EVEN causes the assembler to place the immediately following instruc¬ 
tion or data at an address that is divisible by two. To do this, the assembler inse ts 
a uoa Instruction or a 0 byte In the output file, if necessary. 
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EVENDATA: Adjust the Assembler Location Counter 
to an Even Address 

Applicable assemblers: TASM 2 0. TASM 3 0 
Directive category: Complex data types 
Syntax. 

EVENOATA 

Description: If you are using TASM. this directive is intended for use In data 
segments to align the immediately following data with an even mtmon address. If 
necessary, the assembler will place a 0 byte in the output file to accomplish this. 

This directive is functionally equivalent to the align byte or align 2 directives. 


.EXIT: Specify Program Exit Point 

Applicable assemblers: MASM 6 0. TASM 3 0 
Directive category: Simplified segment control 
Syntax: 

.EXIT 

Description: One of the simplified segment directives available In MASM 6.0. this 
directive should be used In connection with the .startup directive. It allows you to 
specify the exit point of your program. The assembler then automatically generates 
code that "deans up” tasks performed by the code generated by .startup. 

This directive should only be used once, at the end of the main module. 



EXITCODE: Specify Program Exit Point 

Applicable assemblers: TASM 3 0 

Directive category: Simplified segment control 

Syntax: 

EXITC00E 
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r ription: This directive is the same as the EXIT directive. One of the simplified 
segment directives, it should be used with the STARTUPCOOE directive. EXITCODE 
allows you to specify the exit point of your program. The assembler then auiomati* 
cally generates code that “cleans up” tasks performed by code generated b> 
STARTl'PCODE. 

This directive should be used once, at the end of the main module. 


EX3TM: Exit a Macro Immediately 

Applicable assemblers: Microsoft Quick Assembler 2 51, MASM 5 l. MASM 6 0. 
TASM 2.0. TASM 3 0 

Directive category: Macros and repeat blocks 
Syntax: 

EXITM [<exitcode>] 

Description: At times, when you tire working with macros or repeat blocks (using 
the FOB REPEAT. WHILE. IBP. FOSC. IRPC, and PERT directives), you will 
hefor- ihc macro or block lias completed Typically, this happens because a 
condition has been detected that makes exiling mandatory. For instance, you may 
need to exit a FOR block 1/ a predefined variable was set when ihc assembo was 

started. 


EXTERN: Declare aTabel as Being Defined 
in Another Module 

Applicable assemblers: MASM 6.0 

. Crone and visibility 
Directive category: Scope an 
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Syntax: 


EXTERN definition, definition] ... 

where each occurrence of definition has the following construction: 
l language] label[(a It ID)):type 


Description: Ir is very common, especially in larger programs, to have data elements 
or routines that are defined in other modules in other files. The EXTERN directive 
allows you to declare them so that they can be accounted for correctly when the 
current module is being assembled. The EXTERN directive is the same as the EXTRN 
directive. 

At a minimum, you need to provide a label that represents the name of the 
variable or routine, along with a type, which ca:i be any of the following: 

•J A distance declaration such as NEAR, FAR. or PROC 

□ A size declaration such as BYTE. WORD. DWORD. DATAPTR, CODEPTR. 

FWORD, PWORD, QWORD, or TBYTE 

□ A structure name 

□ The special type ABS, which imports label as a constant (numeric external 

declarations only) 

In each declaration, the optional language can be one of the following, 
depending on your assembler: 


Language 


MA$M TASM 


BASIC 

C 

CPP 

FORTRAN 

NOLANGUAGE 

Pascal 

Prolog 

STD CALL 

SYSCALL 


X X 

X X 

X 

X X 

X 

X X 

X 
X 
X 


Any labels declared external are resolved at link time. Any extern references 
must have corresponding PUBLIC references in a different module. 
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EXTERNDEF: MultiUse External Definition 

Applicable assemblers: MASM 6.0 
Directive category: Scope and visibility 
Syntax: 

EXTERNDEF definition , definition 1 ... 

where each occurrence of definition has the following construction: 

[language] labelitype 

t 

Descrip^on: New in MASM 6.0, E RNDEF is an extremely powerful directive. It 
effectively replaces the PUBLIC and EX'rRN or extern directives with a single directive. 
The idea is simple: you create an include file that contains alUhe declarations which 
may be external to any particular module in your program. When you include this 
file in each module, the EXTERNDEF direc e alternately acts as either public or extrn 
(EXTERN), as necessary. Thus, you no longer have to worry whether your extrns 
match your PUBLICS, or vice versa. You can make any changes in one place and have 
them be globally applicable. 

Each EXERNDEF declaration requires, at minimum, a label that represents the 
name of the variable or routine, along with a type, which can be any of the following: 

□ A distance declaration such as NEAR, FAR, or PROC 

□ A size declaration such as BYTE, WORD, DWORD, DATAPTR, CODEPTR, 
FWORD, PWORD, QWORD, or TBYTE 

□ A structure name 

□ The special type ABS, which imports label as a constant (numeric external 
declarations only) 

In each declaration, the optional language can be BASIC, C, FORTRAN, Pascal, 
STDCALL, or SYSCALL. 

If you are using TASM, you can use the global directive instead of externdef. 

EXTRN: Declare a Label as Being Defined 
in Another Module 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 51. MASM 6 0. 
TASM 2.0, TASM 3 0 
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Directive category: Scope and visibility 
Syntax: 

EXTRN definition [, definition ) ... 

where each occurrence of def irut ion has the following construction if you are using 
TASM; 

( language] laPei[ [ arraysize ]): type [: count] 
or the following construction if you are using MASM: 

( language ] label] ( altID)):type 

Description: Having data elements or routines that are defined in other modules 
in other files is very common, especially in larger programs. The EXTRN directive 
allows you to declare these data elements or routines so that they’ can be accounted 
for correctly when the current module is being assembled. 

At a minimum, you need to provide a label that represents the name of the 
variable or routine, along with a type, which can be any of the following 

□ A distance declaration such as NEAR, FAR. or PROC 

□ A sue declaration such as IiYTF, WORD. DWORD, DATAPTR, CODEFTR 
FWORD, PWORD, QWORD. or TBYTE 

□ A structure name 

□ The special type ABS. which imports label as a constant (numeric external 
declarations only) 

In each declaration, the optional language can be one of the following, 
depending on your assembler 

Language M\SM TASM 

BASIC X X 


C 

CPP 

FORTRAN 

NOLANGUAGE 

Pascal 

Prolog 

STD CALL 

SYSCALL 


X 


X 


X 


X 

X 


X 

X 

X 

X 

X 

X 
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Anv labels declared external are resolved at link time. Any EXTRN references 
must have corresponding PUBLIC references in a different module. 


.FARDATA: Define Beginning of Far Data Segment 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category': Simplified segment control 
Syntax: 

.FARDATA [label ]I 

Description: This is one of several simplified data-segment directives available. The 
others include .CONST, .data, .data?, and .FARDATA?. If you are using TASM, you can 
also use CONST. DATASEG. FARDATA. UDATASEG, and UFAROATA. 

This simplified segment directive is used to inform the assembler that the 
information immediately following should be placed in the far data segment. You 
must use the .MODEL directive before using .fardata. 

It is not necessary to use this special type of segment, but you may want to use 
it to group your data. Such grouping may help you understand the different parts of 
your program better. If you use the optional label, it should be a name that guides 
the way the linker combines different far data segments while linking. 

If you are using TASM, this directive is the same as the FARDATA directive. 


FARDATA?: Define Beginning of Uninitialized 
Fax Data Segment 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5.1. MASM 6.0, 
TASM 2.0, TASM 3-0 

Directive category: Simplified segment control 
Syntax: 


•FARDATA? [label] 

Description- This is one of several simplified data segment directives available. The 
others Include .CONST, .data. - d * TA7 '" e u5,n « TASM ' you c2n 

I , ..TAOtr faRDATA, U0ATASEG, ana UFAROATA. 

also use CONST, DATASEG, FAHUAI«, vw 
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This simplified segment directive is used to inform the assembler that the 
information immediately following should be placed in a special uninitialized far 
data segment. You must use the .MODEL directive before using .FAflOATA?. 

It is not necessary to use this special type of segment, but you may want to use 
it to group your data. Such grouping may help you understand the different pans of 
your program better. If you use the optional label, it should be a name that guides 
the way the linker combines different far data segments while linking. 

If you are using TASM, this directive is the same as the UFARDATA directive. 


FARDATA: Define Beginning of Far Data Segment 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Simplified segment control 
Syntax: 

FARDATA ( label 1 

Description: This is one of several simplified data-segment directives available. The 
Others include .CONST.CONST, .DATA. .DATA?, DATASEG. .FARDATA, .FARDATA?. UOATASEG, 
and UFARDATA. This directive is the same as the .fardata directive. 

This simplified segment directive is used to inform the assembler that the 
information immediately following should be placed in the far data segment. You 
must use the .MODEL or model directives before using .fardata. 

It is not necessary to use this special rype of segment, but you mav want to use 
it to group your data. Such grouping may help you understand the different parts of 
your program better, if you use the optional label, it should be a name that guides 
the way the linker combines different far data segments while linking. 



FOR: Repeat a Block of Instructions, Using 
an Argument List 

Applicable assemblers: MASM 6.0 
Directive category: Macros and repeat blocks 
Syntax: 

FOR param, <argH, arg2) ... > 
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Descriptioo: This directive is the same as the IRP directive. It provides a way for the 
assembler to repeat a code block a number of times, substituting different variables 
along the way. 

The param represents a replaceable parameter within the code block. Each time 
pa r am is encountered, it is replaced by an argument from the argument list, which 
is enclosed in angle brackets (< >). On the first iteration, param is replaced by argi, 
the second time with arg2, and so on until each of the arguments has been used or 
an exitm directive Is encountered. 


FORC: Repeat a Block of Instructions, Using a String 

Applicable assemblers: MASM 6.0 
Directive category: Macros and repeat blocks 
Syntax: 

FORC param, <string> 

Description: This directive is the same as the I RPC directive. It provides a way for the 
assembler to repeat a code block a number of times, substituting different variables 
along the way. 

The param represents a replaceable parameter within the code block. Each time 
param is encountered, it is replaced with a character from the string, which is 
enclosed in angle brackets (< >). On the first iteration, param is replaced with the first 
character of string, the second time with the second character, and so on until each 
character of string (including spaces) has been used or an exitm directive is 

encountered. 


FWORD: Allocate 6 Bytes of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

(label] FWRD expression (, expression] 

_ is eauivalent to the OF directive. It is used to allocate 6 

£rT 0 “ : ^fordau - ^ cxccuubl. WcT>p,c^ y . ,hls <ta.» sue.» u-d 

bytes of memory . ' gQ386 or 80486 environment. The label is a user- 

ior 48-b\i far pomte symbolically to the stored information. Each 

defined name you can use later w / 

expression must be one of the folio g 
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□ A number between -140,737.488,355,328 and 281,474.976,710 655 

□ A formula resolving to a number between -140.737.488,355.328 and 
281,474,976,710,655 

□ A 48-bit far-address pointer (segment and 32-bit offset) 

□ A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the fword directive is longer than six bvtes, the label 
refers only to the first six bytes of the allocated data. 


Examples: 



FarAddress 

FWORD 

Routine 

Values 

FWORD 

2.345, 59.682 

Counter 

FWORD 

0 

MemArea 

FWORD 

1024 • 64 • 4 

Array 

FWORD 

12 DUP(?) 



GLOBAL: MultiUse Global Definition 


Applicable assemblers: TASM 2.0, TASM 3.0 
Diivctive category: Scope and visibility 

Syi ax: 

GLOBAL definition], definition ] ... 

where each occurrence of definition has the following construction. 


[language] label[[arraysize] ): type [: count J 

Description: GLOBAL is a very powerful directive. Ft effectively replaces the pur. rr 
and EXTRN directives with a single directive The idea is simple: you create an 1 ^ 
file which contains all the declarations that may be external to any particul vLi i 
in /our program. When you include this file in each module, the GLOBAL 
alternately acts as either PUBLIC or EXTRN, as necessary. Thus, you no Ion 
worry whether your EXTRNs match your PUBLICS, or vice versa You c °^ Cr , aVC l ° 
changes in one place and have them be globally applicable Ca ° ma ^ e 


Each global declaration requires, at minimum, a label thar 
name of the variable or routine, along with a type, which can be any ofdfJfoUou ^ 
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J A distance leclaration such as NEAR, FAR, or PROC 

J A size decimation such as BYTE, WORD, DWORD, DATAPTR, CODEPTR. 
FWORD, PWORD QWORD. or TBYTE 

□ A structure name 

□ The special type ABS. which imports label as a constant (numeric external 
declarations only) 

In each declaration, the optional language can be BASIC, C, CPP, FORTRAN, 
NOLXNC.V'ACE, Pascal, or Prolog. 

If you are using MASM 6.0, you can use the EXTERNDEF directive instead of 
GLOBAL. 


GOTO: Transfer Control 

Applicable assemblers: MASM 6.0. TASM 3 0 
Directive category: Macros and repeat blocks 
Syntxx: 

GOTO macrolabel 

Description: The GOTO directive, which must be used inside macros or repeat blocks, 
is used to transfer control. It works just like the GOTO statement in MS-DOS batch files. 
When GOTO is executed, control is transferred to macrolabel, which is designated by 


a colon followed by macrolabel. 


Example: 



• 

DOSCall 

MACRO 

IFB 

GOTO 

Service 

<Service> 

BadCall 

;Was there an argument? 

;No, so go handle 


ENDIF 

MOV 

I NT 

AH,Service 

21b 

;Load service in proper place 
;D0S interrupt 

:BadCall 

EXITM 

ECHO 

.ERR 

ENOM 

Sorry, but 

you called DOSCall without an argument! 


943 
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GROUP: Specify Common Segment Grouping 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Complete segment control 
Syntax: 

label GROUP seglabell, seglabel J ... 
or, if you using TASM in ideal mode: 

GROUP label seglabel[, seglabel] ... 

Description: This directive allows you to specify a name for a group (label), and 
which segments (seglabel) belong to that group. The linker uses this information 
to determine how to order segments in the executable file. 


IDEAL: Enter Ideal Assembly Mode 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: Global control 
Sytatax: 

IDEAL 

Description: Unique to TASM, ideal mode is used to modify the way the assembler 
operates. In ideal rpode, the assembler is less forgiving and more structured in what 
it will and will not accept in a source code file. Ideal mode is discussed more fully 
elsewhere in this book. 


.IF: Conditional Program Execution 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

•IF condition 
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Description: This directive, in conjunction with the .ENDIF directive, can be used 
in assembly language programs to provide the same functionality as their counter¬ 
parts in high-level languages. 


The condition used by the .IF directive must resolve to either true or false. It 
can be complex (testing for two or more conditions), and may contain any of the 
following operators: 

Operator Meaning 

ss 

Equal 

1 = 

Not equal 

> 

Greater than 

> = 

Greater than or equal to 

< 

Less than 

< = 

Less than or equal to 

& 

Bit test 

&& 

Logical AND 

II 

Logical OR 

I 

Logical NOT 

You can also test automatically the condition of flags by using the following 

specialized flag-name operators: 

Operator 

Sample Use 

CARRY? 

.BREAK .IF (CARRY?) 

OVERFLOW? 

.BREAK .IF (OVERFLOW?) 

PARITY? 

.BRCAK .IF (PARITY?) 

SIGN? 

.BREAK .IF (SIGN?) 

ZERO? 

.BREAK .IF (ZERO?) 


Example: 

GetKey: 


MOV 

INT 

.IF 

AND 

.ENDIF 

.IF 

MOV 


AH;7 

21h 

(AL >= '*') !'• 

AL.OSFh 


;Direct character input without echo 
;DOS services 
(AL <* * z *) 

;Convert to uppercase 


AL « •*' 

BX| OFFSET Exit 


-.Address of exit routine 
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.ELSEIF 

AL =* 'B' 

MOV 

Bx, OFFSET Beginning 

.ELSEIF 

AL == -F' 

MOV 

BX, OFFSET FileOps 

.ELSE 

MOV 

BX, OFFSET GetKey 

.ENOIF 

JMP 

[BX] 


{Address warm program start 
{Address of file operations 
{Beginning of this routine 
;Jump to right routine 



IF: Conditional Assembly 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6 0 
TASM 2.0, TASM 3.0 YV 

Directive category: Conditional assembly 


Syntax; 


If expression 

Description This directi'c, in conjunction with the ENDIF directive, can be used in 
assembly language programs to control which portions of the code are assembled. 

issemlhvMf r d h rtianaJ expressi0n must cvaJuate to tnjc fo ‘ d* following code to be 
c . ' c ex P ression ^ not true, assembly continues at the next ELSEIF, ELSE 

X END IF directive 

-jcample: 
jeiacOount 


0W 
IP 

DemoMessaae DB 

ELSEIP 

DemoMessage D6 
els: 


Demo E3 1 

This is a oa-e bones demo version of the prooranT . 0 
De-* to ? 

This is a deluxe demo version of the program ’,# 


%CJT Demo value is not set correctly 
ENDIP 



1F1: Assemble If on Assembler Pass 1 

TASSVW) 1 * ****"“*"“ Quick Assembler 2 51 


VU.F' 


r i. 7 ASM 2.0, 
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Directive category: Conditional assembly 

Syntax: 

IF', 

Description: This directive is meaningful only in old versions of MASM (prior to 
MASM 6.0) and if you are using TASM in multipass mode MASM 6 0 is a single-pass 
assembler, as is TASM, under normal circumstances. 

If this directive is used, it is treated essentially the same as the IF directive. The 
conditional assembly block is terminated with the END IF directive. 


IF2: Assemble If on Assembler Pass 2 

Applicable assemblers: Microsoft Quick Assembler 2 51, MASM 51, TASM 2.0, 
TASM 3 0 

Directive category: Conditional assembly 

Syntax: 

IF2 

Description: This directive is meaningful only in old versions of MASM (prior to 
MASM 6 0) and if you are using TASM in multipass mode. MASM 6 0 is a single-pass 
assembler, as is TASM, under normal circumstances. 

Because this directive is obsolete, using it with MASM 6 0 results in ar error 
message being generated TASM generates a warning message onl> if turct. ming in 
the default single-pass mode. The conditional assembly block is terminated with the 

EN0IF directive. 



IFB: Assemble If Blank 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5 1. MASM 6 0, 
TASM 2 0, TASM 3 0 

Directive category: Conditional assembly 

Syntax: 

IFB *»rgumtnt* 
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Description: This directive is used to start a conditional assembly block Typically, 
this directive is used in macros. If the argument, enclosed in angle brackets (<>), 
is blank, the subsequent instructions are assembled. If not, assembly continues after 
the next ELSE, ELSEIF, or endif directive. 


Example: 



DOSOut 

MACRO 

Service 


IF3 

<Service> 


MOV 

ELSE 

AH,2 


MOV 

ENOIF 

AH,Service 


INT 

ENOM 

21 h 


;Was argument blank? 

;Yes, so use default output 

;lcad service in proper place 

;D03 interrupt 


'IFDEF: Assemble If Defined 

.Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 1 MASM 6 0 
TaSM 2 0. TASM 3 0 

Directive category: Conditional assembly 


Syntax: 

IFOEF Label 

Description: When you are working in a large program, remembering whether you 
already have generated symbols is difficult—particularly if you are using macros. If 
you already have defined label and this directive is encountered, the code immedi¬ 
ately following the directive is assembled. 


Example: 




VerMsg 

MACRO 

version 

f 


. ERR8 

<Version> 

;Need to have a version argument 


IFDEF 

Decio 

VersionMsg 

OB 

’This is a demo 

version of the program',0 


ELSE 


VersionMsg 

OB 

ENOIF 

ENDM 

‘This is version 

Aversion of the progran',0 
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IFDIF: Assemble If Strings Are Different 

t??Ii C fn 1 T a ^ SemblerS: Microscfl Quick Assembler 2 51, MASM 5.1. MASM 6 0, 
TA5M 2.0, TASM 3 0 


Directive category: Conditional assembly 
Syntax: 

IFDIF <string1>,<$tring2> 


% 

Description: Sometimes being able to assemble different versions of software, 
based on comparisions, is handy. This directive compares two strings and, if they are 
different, assembles the following instructions Both stringi and string2 must be 
enclosed in angle brackets (< >); either one of them can be an argument name (if 
in a macro). IFDIF is case-sensitive— stringi and string2 have to match, character 
for character. 


Example: 


VerMsg MACRO 

.ERRB 
IFDIF 

VersionMsg DB 
ELSE 

VersionMsg DB 

ENDIF 

ENDM 


Version 

<Version> ;Need to 

<Ver$ion>,<9> ;ls this 

‘This is version iVersion of 

'This is a deluxe version of 


have a version argument 
version 9? 
the program',0 

the program',0 



IFDIFI: Assemble If Strings Are Different 
(Case Insensitive) 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3.0 

Directive category: Conditional assembly 
Syntax: 

IFDIFI <str~ng1> ,<string2> 

Description: This directive is essentially the same as IFDIF, except that it is 
insensitive to case. 
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Sometimes being able to assemble different versions of software, based on 
compansion^ is hands This directive compares two strings and. if they are different, 
assembles the following instructions Both strmgi and string2 must be enclosed in 
angle brackets (< >); either one of them can be an argument name (if in a macro). 

Example: 


verMsg UACRO version 

<version> ;Need to 

1F0IFT «verslon»,<De<no> ;U tnle 

VersionMsg CB ‘This is version ive-sion of 
ELSE 

versionMsg 03 'Tims is tne de*o version of 
ENOIF 


hive a version argument 
the aeno version? 
the program,® 

tne program’,® 


ENOM 


IFE: Assemble If False 


Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5 1, MASM 6 0, 
TASM 2 0. IASM ) 0 

Directive category: Conditional assembly 


Syntax: 

- 


IFE tupression 

Description: This directive controls whether a block of instructions is assembled, 
based on whether die expression resolves to be false id) If the expression is false, 
the instructions arc assembled 


Example; 

IFE 

e-f*Sire 

;Is tne buffer 

size specifies 

BuffSize 

EQO 

1024 

;*o, to set to 

oe'ault 

Buffer 

ENOIF 

OB 

BuffSize DuF (B) 




IFIDN: Assemble If Strings Are Identical 

Applicable assemblers Microsoft C'uick .Assembler 2 31 MAS VI 3 i stvsvt 6 0 
TASM 2 0 TASM 3 0 
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Directive category*: Conditional assembly 
Syntax: 

IFION <stringl>,<string2> 

Description: This directive compares the contents of two strings and, if they are 
identical, assembles the instructions in the conditional block immediately following 
the IF ion directive. Both stringi and strinfl2 must be enclosed in angle brackets 
(< >);«ithcr one of them can be an argument name (if within a macro). Ifidn is case- 
sensitive stringi and string2 have to match, character for character. 


Example: 

IFIDN 

<Version>,<9> 

; Is this 

version 9? 

BuffSize 

EQU 

4096 

;Yes, so 

use larger buffer size 

BuffSize 

ELSE 

ECU 

1024 

;No, so 

use standard buffer size 

Buffer 

ENDIF 

DB 

BuffSize DUP (0) 




IFIDNI: Assemble If Strings Are Identical 
(Case Insensitive) 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2 0, TASM 3 0 

Directive category: Conditional assembly 
Syntax: 

IFIDNI <stringi>,<string2> 

a 

Description: This directive is essentially the same as ifidn, except that it is not case- 

sensitive. 

This directive compares the contents of wo strings and. if they are identical, 
assembles the instructions in the conditional block immediately following the 
IFIDNI directive. Both stringi and st nnQ2 must be enclosed in angle brackets (< >); 
cither one of them can be an argument name (if within a macro). 


Example*. 

IFIDNI 

<Version>,<Oemo> 

;Is this a demo version? 

BuffSize 

EOU 

512 

;Yes, so use limited buffer size 


ELSE 
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BuffSize 
Buffer 


EQU 4096 

ENDIF 

OB BuffSize OUP ( 0 ) 


;No, to uct* bo ftef ») . 1 * 


IFNB: Assemble If Argument Is Not Blank 

Applicable assemblers: Microsoft Quick Assembler 2 SI, MASM 54, MASM 6 0, 
TASM 2.0, TASM 3 0 

Directive category: Conditional assembly 
Syntax: 

IFNB 

9 

Description In macrodcfimiions, this directive is used to test whether an •raiment 
was passed to the macro If one was passed, the conditional assembly block is 
assembled The label of the argument to be tested, argument, must be enclosed in 
angle brackets (<>). 


Example: 




verMsg 

MACRO 

Version 



IFNB 

<Version> 

;Is there a version specified? 

VersionMsg 

0B 

EN0IF 

EN0M 

’This is version 

aversion of the program’,0 



IFNDEF. Assemble If Not Defined 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 J, MASM 6 0. 
TASM 2 0. TASM 3 0 

Directive category: Conditional assembly 
Syntax: 

IFN0EF label 

Description: When you are working in a large program, remembering whether vou 
already have generated symbols is difficult—particularly if you are using macro*- 1/ 
you have not defined label and this directive is encountered, the code immediate!) 
following die directive is assembled. 
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Example: 


VerMsg 

MACRO 


. ERRB 


IFNDEF 

versionMsg 

DB 


ELSE 

VtrsionMsg 

DB 


ENDIF 


ENDM 


Version 

<Ver$ion> ;Need to have a version argument 

Demo 

’This is version Aversion of the program",0 
'This is a demo version of the program",0 


%INCL: Enable Listing of INCLUDE Files 

Applicable assemblers: TASM 2.0, TASM 3-0 



Directive category: Listing control 
Syntax: 


\INCL 

Description: Normally, TASM lists INCLUDE files as the) are 
listing of INCLUDE files can be turned off, however, with the * 
Later, if you want to have them listed, you can use the %INCL irectivc. 


INCLUDE: Insert Source Code from Another File 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Scope and visibility 


Syntax: 

INCLUDE filename 

or, if using TASM in ideal mode: 


INCLUDE • filename * 

, . iKiri tide files is quite common in assembly language Program- 

Description: Using os an( j common definitions in a single file, and then 

ming You can place ma programs INCLUDE files can be nested 

include them where necessary in you P 
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When the assembler encounters the Incluoe directive, it determines whether 
you have provided a complete file name. If you have not provided an extension for 
your file name, the extension ASM is assumed. If you have not specified a complete 
path for the file, rhe assembler looks for the file in the following places: 

□ In the current directory 

□ In any directories specified on the assembler command line 

□ In any directories specified with the include option in the environment 

If the assembler still cannot locate the INCLUDE file, an error is generated. 



INCLUDELIB: Specify Library for Linker To Use 

MiCr ° SOft Qu ‘ Ck Asscmbler 2 51, MASM 5.1, MASM 6. 


0, 


Directive category: Scope and visibility 
Syntax: 


INCLUDELIB filename 

or, if using TASM in ideal mode: 

INCLUDELIB m filename’ 


a ° “ ...I. m 2 



INSTR: Return a Position 

Applicable assemblers. Microsoft 
Directive category: String control 
Syntax: 


of One String in Another 

Quick Assembler 2.51. TASM 2.0, TASM 3.0 


label INSTR [start, )fullstring, substring 

Description; ‘This directive functions much like its counterpart in «« ■ 

languages When assembled, it resolves to a single number- either T' high * ,evd 

substrinflmfullstrxnfl.orOifsubstrinBcannotbcfoundinfunTr eP ° Sition of 

you can provide a start position where searching should bro;« ^ ^P l *°naJly, 

°cgin within full 5 tnn 9 . 
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For instance, the following statements 

veroate TEXTEQU 1 10 13/1991 * 

Divided INSTR Verdate, </> 

0ivider2 INSTR Oividedd, Vercate, </> 

result in Divided being equal to 3. and Divider2 being equal to 6. 


INVOKE: Execute a Procedure 

Applicable assemblers: MASM 6.0 

Directive category: Procedures and code labels 

Syntax: 

INVOKE expression!, argument) ... 

Description: Th» directive can be used to execute a procedure. NormaUy. this Is 
done by the call instruction, but invoke enables you to specify an argumen 
pass (ria the stack) to the procedure. The «,pr,ss:on can be »ny procedure.abrior 
a specific address pointer. If the arguments being passed by invoke are no 
L fto* expected by the procedure, the assembler will make sure that the correct 

code Is generated to widen the arguments to the proper w» 


IRP: Repeat a Block of Instructions, Using 
an Argument List 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 51. M 
TASM 2.0, TASM 3 0 

Directive category: Macros and repeat blocks 

Syntax: 

IRP pa ram, <argi[, *rg2) ••».* . 

Description: This directive provides a way for the assembler to repeat a co e oc 
severe! times, subs.im.ing different vanables along the way. 

The param repr * $e ^ ^^uce^by^^a^mVr^ftom foVat^ment lis^w'hich 
param is encountered. « f^ Qn thc first iteration param is replaced by argi. 

is enclosed in angle nrac unU i eac h of thc arguments has been used or an 

the second time by a rg2, anu » 

EXITU directive is encountered. 

a i a cm 6 0 you can use the for directive insiead of IRr. 

If you are using MASM O.u. ) 


Scanned with CamScanner 








956 Pan IV Reference 


I RPC: Repeat a Block of Instructions, Using a String 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2 0. TASM 3 0 

Directive category: Macros and repeat blocks 
Syntax: 

IRPC param, <string> 

Description: This directive provides a way for the assembler to rep eat a code block 
a number of times, substituting different variables along the way. 

The param represents a replaceable parameter within the code block. Each time 
param is encountered, it is replaced by a character from the string, which is enclosed 
in angle brackets (<>). On the first iteration, param is replaced by the first character 
of string, the second time by the second character, and so on until each character 
of string (including spaces) has been used or an exitm directive is encountered. 

If you are using MASM 6.0, you can use the FORC directive instead of IRPC. 


JUMPS: Enable Jump Stretching 

Applicable assemblers: TASM 2 0, TASM 3 0 
Directive category: Global control 
Syntax: 

JUMPS 

Description: After this directive is executed, TASM analyzes every branching 
operation in your source-code file; if you have specified a short jump that cannot be 
accomplished, the assembler generates the proper code to allow the jump to occur. 



LABEL: Define a Symbol 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 


Directive category: Procedures and code labels 


\ 
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Syntax: 

name LABEL type 

or, if using TASM in ideal mode. 

LABEL name type •- 

Description: With this directive you can define a specific position in your source file, 
assigning it a label name. The type can be any of the following: 

□ NEAR, FAR, or PROC 

□ BYTE. WORD, DATAPTR, CODEPTR, DWORD, FWORD, PWORD, QWORD, 
or TBYTE 

□ A structure name 


.LALL: Enable Listing of All Macro Expansions 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3-0 

Directive category: Listing control 

Syntax: 

.LALL 

Description: This directive is used to reverse the effects of the .XALL directive. 
Normally, the assembler only expands macros that result in code being generated. 
After this directive is executed, all macros are expanded, regardless of whether they 
result in code being generated. 

If you are using TASM, this directive is the same as the MAACS directive. If you 
are using MASM 6.0, this directive is the same as the .LISTMACROALL directive. 



LARGESTACK: Specify 32-Bit Stack Pointer 

Applicable assemblers: TASM 3.0 
Directive category: Global control 
Syntax: 

LARGESTACK 
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Description: Normally, the prologue and epilogue code generated automatically by 
TASM controls the way a procedure uses the stack. If you are using an 80386 or 
80486. however, you can use either a 16-bit or 32-bit stack pointer. This directive 
overrides the default stack size selected with the .model or model directive, and 
ensures that a 32-bit pointer is used. 


•LFCOND: List All Conditional Statements 

tJSmT^TASmTo 1 ^' M ‘ CrOS ° ft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 

Directive category: Listing control 
Syntax: 

.LFC0N0 

Des c ri p ti°n : Instructs the assembler to include all conditional code in the listing 
file whether ,t ,s included in the OBJ file or not. If you are using TASM. this directive 
“ the ' C0N0S directive. Under MASM 6.0, this is the same as the . L 1 ST 1 F 


%LINUM: Set Listing-File Line-Number Field Width 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syn'ax: 

HLINUM width 

d^v P e?on^ during assemb.y, this 

is 4 characters wide wh.ch will * fi L dd ,n '“dng. The default value 

source files, you will want to make ^ field^CfaT “ P “ “ y ° U 1 " 8er 



%L1ST: Enable Source-Code Listing 

Applicable assemblers: TASM 2 0, TASM 3 o 
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Directive category: Listing control 
Syntax: 

%11ST 

Description: The %LIST directive is the same as the .LIST directive. Executing this 
directive results in a listing file being generated by the assembler. TASM does this by 
default, but if you use the HNOLIST directive, you can cause TASM not to write the 
source lines to the file. You can use both SNOLIST and %LIST to control selectively 
what goes into the listing file. 


.LIST: Enable Source-Code Listing 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, • 
TASM 2.0, TASM 3.0 

Directive category: Listing control 

Syntax: 

.LIST 

Description: Executing this directive results in a listing file being generated by the 
assembler. The assembler normally does this by default, but if you use the .XLIST, 
NOLIST or HNOLIST directives, you can cause the assembler not to wnte the source 

lines to the file. You can use both groups(. XLIST, .nolist, and .LiST.orWOLlSTand 

%LIST) to selectively control what goes into the listing file. 

The ALIST and SNOLIST directives apply only if you are using TASM. The .NOLIST 
directive is available only under MASM 6.0. 


.LISTALL: Include Everything in Listing File 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
Syntax: 

.LISTALL 

_ . directive results in the most information in your listing file. It will 

inctuctiTalTsource-code lines. aU micro expansions, and all conditional., whether 
they arc fal^c or not 
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.LISTIF: List All Conditional Statements 

Applicable assemblers: MASM 6 0 
Directive category: Listing control 
Syntax: 

.LISTIF 

Description: Normally, MASM includes conditional assembly statements in the 
listing file only if they result in generated code This directive, however, causes all 
conditionals to be included This is the same as the .lfcono directive. 


.LISTMACRO: List Only Macros that Generate Code 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
Syntax: 

' ISTUACRO 

Description: If you use macros a great deal, you probably will use this directive also 
It results only in the expansion (listing) of macros that generate code. This directive 
is the same as the .xall directive. 



LISTMACROAJLL: Enable Listing of All Macro Expansions 

Applicable assemblers: MASM 6 0 
Directive category; Listing control 
Syntax- 


.LISTMACROALL 


Description: Tins directive « used to revere, the effects of the . USTtuCRO directive. 
Normally, the assembler expands only macros that result in code beta* generated. 
After this directive is executed. aU macros are expanded, regardless of whether they 
result in code being generated. ' 


This directive is the same as the call directive 
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LOCAL: Define Local Variables 

Applicable assemblers: Microsoft Quick Assembler 2.31. MASM 5.1. MASM 6.0. 
TASM 2.0, TASM 3 0 

Direttlve category: Procedures and code labels, macros and repeat blocks 
Syntax: , • 

• t . 

LOCAL vardef[, varddf) ... [ e siz*ia£>?J] 
where each vardef has the following construction: 
labal[[arraysize 111: type!(: count) 

Description: This directive is used to define local variables for pse within a 
procedure or a macro. Space for these variables is allocated on the stack and released 
when a procedure is finished. 

The label is the symbolic name used to reference the variable in the procedure. 
The optional arraysite, enclosed in brackets ((]), specifies the size of the array 
referred to by label. The type is a data type such as BYTE, WORD, etc. TASM also 
allows you to specify a count that indicates how many of the t ype should be allocated. 
In this case, the total size allocated for label would be arraysize times count times 
the width of typa. 

Notice that no allowance is made for initializing local variables. You must do 
this manually in your procedure. 

The optional aizelabel designates a symbolic name which should be assigned 
a value equal to the amount of space required by all the local variables. This option 
is not available in MASM 6.0. 



LOCALS: Enable Local Symbols 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Procedures and code labels 

Syntax: 


LOCALS [prafix] 

Description- This directive allows you to enable the assembler to process local 
symbols and optionally change the prefix characters assigned to local symbols. 
Normally the characters ^(a arc used to begin local symbols You can use this 
directive to change this prefix to any other two characters (such as ::) that the 
assembler does not reserve for some other use. 

To disable local symbols, use the NOiOCALS directive. 
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MACRO: Define the Start of a Macro 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0. TASM 3.0 

Directive category: Macros and repeat blocks 
Syntax: 

laoei MACRO (parameter!, parameter] ...) 
or, if using TASM in ideal mode: 

MACRO label [parameter], parameter J ...] 

t 

Description: Macros can be used to handle automatic code generation or to pro* 
vide a different name for an operation. The assembler includes an entire macro 
language, composed of directives. which can be used between the MACRO directive 
and the endm directive. 

Example: 


ooscail 

MACRO 

Service, Rune 


ERR If- B 

<ServiCC ; * 


ERRIFNB <Func> 


MOV 

AH,Service 


INT ' 

21 h 


ENDM 



;Need to have a service argument 
ICant allow functions; haven't coded for yet 
;Load service in proper piece 
;D0S interrupt 



%MACS: Enable Listing of All Macro Expansions 

Applicable assemblers. TASM 2.0, TASM 3.0 


Directive category': Listing control 
Syntax: 


%MACS 


Description: This directive is the same as the .LAU directive. It is used to reverse 
the effects of the hnomacs directive Normally, the assembler expands onlv macro, 
t at rtsut m c e ing generated. After this directive is executed, all macros are 
expan e , reg ess of whether they result in code being g n< rated 
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MASM: Enable MASM 4.0 Compatibility 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Global control 
Syntax: 

MASM 

Description: Some differences between TASM and MASM may cause problems with 
the way your source code assembles. Use this directive to instruct TASM to operate 
in a manner compatible with MASM 4.0. 

Instead of using this directive, you may want to use the VERSION directive, which 
is new'to TASM 3 0. . - 




tteiIM.Tii * Mihm 4+ «■—- i ■■ - 

MASM51: Enable MASM 5.1 Compatibility 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Global control 

- it- :15 

Syntax: 

MASM51 

e _ • ;|iri M n t maSM 5 1 are not in the default configuration of 

TASfaA&crthbditealve is executed, TASM will be able to understand and properly 
process the following. 

□ SUBSTR, CATSTR, SIZESTR, and INSTR directives 

□ Line continuation with » backslash character (') 

Uter, if you want to disable MASM 5.1 compaiibility, you can use die ROMASUS. 

directive. . ... 

Instead of using this directive, you may want to use the VERSION directive, which 

is new to TASM 3.0. „ . 


MnnEL. Soecify Memory Model 

.. _ Microsoft Quick Assembler 2.51, MASM 51. MASM 6.0, 

Applicable assemblers. 

TASM 2.0, TASM 3-0 
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Directive category: Simplified segment control 
Syntax: 

.MODEL memorymodel[, language 1(, opsys](, modelmod] 

If you are using TASM, the following syntax also can be used: 

.MODEL l modelmod] memorymodel [label] [ ,[ langmod] language ][, modelmod] 

Description: This directive allows the assembler to determine how to handle all the 
other simplified segment directives. Basically, it is here that you define the environ* 
ment for which you are programming. 

Notice that the only required parameter is the nsnorynodtl, which can be any 
of the following memory models, depending on your assembler. In addition to valid 
mtmorymodsl, this able indicates the applicable assemblers and assembler assump* 
tions for each ssmorymodtl. 


Model 

MASM 

TASM 

Code 

Data 

CS Group 

DS Group 

SS Group 

TINY 

X 

X 

NEAR 

NEAR 

DGROUP 

DGROUP 

DGROUP 

SMALL 

X 

X 

NEAR 

NEAR 

_TEXT 

DGROUP 

DGROUP 

COMPACT 

X 

X 

NEAR 

FAR 

.TEXT ‘ 

DGROUP 

DGROUP 

MEDIUM 

X 

X 

FAR 

NEAR 

lafctl.TEXT DGROUP 

DGROUP 

LARGE 

X 

X 

FAR 

FAR 

label_TEXT DGROUP 

DGROUP 

HUGE 

X 

X 

FAR 

FAR 

l«bel_TEXT DGRCUP 

DGROUP 

FIAT 

X 

X 

NEAR 

NEAR 

FLAT 

FIAT 

FLAT 

TCHUGE 


X 

FAR 

FAR 

label.TEXT NOTHING 

NOTHING 

TPASCAL 


X 

NEAR 

FAR 

CODE 

DATA 

NOTHING 


If you are using TASM. you can also specify an optional label when using the 
MEDIUM. LARGE. HUGE, or TCHUGE memory models. This label bused* 

assigning a code segment GROUP name. If you do not provide a label, then the 
module name is automatically used. 

The assembler uses the optional language parameter to set calling, namina. 
and parame.rr-passing conventions for procedures and public symbols. TTUs parang 
eter may also determine how the automatic prologue and epilogue code foreach 
procedure Is generated. The language can be any one of the following, depend 
on your assembler.- * 
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Language _ MASM . 7AS.V/ 

BASIC X - X 

C XX 


CPP X 

FORTRAN X X 

NOLANGUAGE X 

Pascal X X 

Prolog X 


STDCALL X 

SYSCALL X 


Notice that if you are using TASM, you can further specify a language modifier, 
lan^od, which can be NORMAL, WINDOWS, ODDNEAR, or ODDFAR. Again, this 
parameter is used to control the procedure prologue and epilogue generation. 

When using MASM 6.0, you can also specify an operating system, opsys, for the 
memory model. This parameter, which can be either OS_DOS or OS_OS2, controls 
the way the .startup and .EXIT directives generate their code. If you do not use 
.startup and .EXIT in your programs, you do not need to specify the opsys 
parameter. 

Finally, aodolaed is a model modifier typically used to specify how the stack 
should be grouped with ocher GROUPS. The use of this parameter is expanding, 
however, to control ocher things (depending on your assembler). The valid aodolaod 
settings are as follows: 

Modifier MASM TASM • Meaning _ 

NEARSTACK X X Sack segment should be included 

in DGROUP 


FAJtSTACK X 

USE16 

USE32 


Sack segment should not be 
included in DGROUP 

Use 16-blt segment addresses for 
80386 or 80486 

• Use 32*blt segment addresses for 
80386 or 80486 


Notice that If you are using TASM, aodslaod can appear either before or after 
the asaoryaodsl. 

If you are using TASM, you can also use the U00EL directive rather than .model. 
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MODEL: Specify Memory Model 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: Simplified segment control 
Syntax: 

MODEL (mocfcimod) rnemorytnodel (label)(,[ langmod] languaga][, modelmod J 

Description: Applicable only with TASM, this is an alternate method of specifying 
the memory model. It works exactly as the .MOOEl directive does. See the discussion 
under that directive for more information. 



.MSFLOAT: Specify' Microsoft Floating-Point Format 

Applicable assemblers: Microsoft Quick Assembler 2.51 

Directive category: Clobal control 

Syntax: 

.MSFLOAT 


--— ui uic muruson Dinary format. 




Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Global control 
Syntax: 


MULTERRS: Enable Multiple Error Reporting 


MULTERRS 



reports the first error It finds on 
semblcr to evaluate each line and 


The effects of this directive can be 


reversed with the novulterrs uixective 
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NAME: Define the Module Name 


Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0, 

TASM 2.0, TASM 3 0 

Directive category: Global control 

Syntax: 

NAME label 

Description: This directive allows you to assign a symbolic , ^" c l ° t ^" odulc 
being assembled. Normally, the module has the same name as the file turn . 

Note that this directive has meaning only in TASM ideal mode. 

. . Ti r M >. macm mode or in any version of MASM. 

generate errors or warnings in TASM s MASM moae, or 7 fl . created 

iven though it does not generate an error, it has no effect on the ob,ect file created 
by the assembler. 


%NEWPAGE: Advance Listing File to New Page 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: listing control 


Syntax: 

VJEWPAGE 


Description:ThUis 

the listing file jumping to the top ot a new ™ 


.N087: Disable Numeric Coprocessor Programming 

Applicable aaaembteW! MASM 6-0 
DirtCivc category r»c«ssor speclScatio^ 

Syntax: 

I4Q07 

_ ^ u..it MASM allows you to program for the 8087 numegc 
Description: By de * au **’ Ae >2 a7. ,M7, .4§e, or .smf directives to enable 
coprocessor. You can also 
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varying levels of NPX compatibility. This directive, on the other hand, disallows all 
programming for a numeric coprocessor. If you know you are programming for an 
environment where there is no coprocessor chip, you can use this directive if you 

want to make absolutely sure that there will be no incompatible code in your 
program. 


%NOCONDS: List True Conditional Statements 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 


%N0C0NDS 

Description: This is the same as the . SFC0N0 directive. It instructs the assembler to r 
include only conditional code (no other kind) in the listing file only if the condition 
is true. In other words, only code that makes it to the OBJ file will be listed. 


96NOCREF: Disable Cross-Referencing 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 


%N0CR£F [labelr, label) ...] 

Description: This directive is similar to the .XCREF directive, bur much more 
versatile. If this directive is executed without any parameters, cross-referencing Is 
turned off completely, both in the listing file and the XRF file. If you Include one or 
more labels, however, only cross-referencing for those labels Is affected. 

If you are using MASM 6.0, you can use the .NOCftEF directive. 


r 


.NOCREF: Disable Cross-Referencing 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
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Syntax: 

.NOCAEF (labsll, label] ...] 

Description: This directive is similar to the .XCREF directive, but much more 
versatile. If this directive is executed without any parameters, cross-referencing is 
turned off completely. If you include one or more labels, however, only cross- 
referencing for those labels Is affected. 

If you are using TASM, you can use the hnocref directive. 


%NOCTLS: Exclude Listing-Control Directives 
from the Listing File 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Listing control 
Syntax: 

%N0CTLS ' 

Description: Normally, TASM does not Include listing-control directives in a 
generated listing file. The hnoctls directive restores this default if you have used the 
%CTLS directive to cause listing-control directives to be Included. 


NOEMUL: Don’t Use Floating-Point Emulator ^ ^ „ 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Global control 
Syntax: - 
NOEMUL 

Description: By default, TASM assumes that you have some sort of numeric 
coprocessor present in your system. This means that while assembling, the assem¬ 
bler generates code that can take advantage of the coprocessor. If you previously 
used the euul directive end now went to turn off emulation, you con use this directive 
to do so. Unless you have previously used the euul directive, using noemul is 

unnecessary. 
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%NOINCL: Disable Listing of INCLUDE Files 

Applicable assemblers: TA5M 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

VIOINCL ^ 

Description: Normally, TASM lists INCLUDE files as they are encountered. The 
listing of INCLUDE files can be turned off, however, with this directive. Later, if 
you want to have these files listed, you can use the %INCl directive. 




NOJUMPS: Disable Jump Stretching 

Applicable assemblers: TASM 2 0 TASM 3 0 
Directive category: Global control 
Syntax: 

NOJUMPS 

Dcscripfionyi/mp nracbmg * rt* automatic rewriting of your branching insuuc- 
lions to avoid errors caused ov t.-. mg to short jump loo far. TASM normally does not 
do jump stretching, unless vou use the jumps directive, nojumps can then later be 
used ro again disable jump stretching 


%NOLIST: Disable Source-Code Listing 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

VJOIIST 

Description: This directive is the same as the .xlist directive. Use this directive to 
mstruct the assembler to suspend sending listing information to the listing file Even 
with this directive in place, however, the assembler will include svmbol and cross- 
reft. rr.ce infijrmarion in the file. 
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.NOLIST. Disable Source-Code Listing 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
Syntax: 

.NOLIST 

Description: Use this directive to instruct the assembler to suspend sending listing 
information to the listing file. Even with this directive in place, however, the 
assembler will include symbol and cross*reference information in the file. 

This directive is the same as the .xlist directive. 



.NOLISTIF: List True Conditional Statements 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
Syntax: 

.NOLISTIF • - - „ 

Description: Instructs the assembler to include only conditional code (no other 
kind) in the listing file only if the condition is true. In other words, only code that 
makes it to the OBJ file will be listed. This directive is the same as the .SFC0N0 
directive. 



.NOLISTMACRO: Disable Macro Listing 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 


S ySljR - ——- t. —r. -r- 

.NOLISTMACRO 

^ k,«^,-Uv the assembler lists (in the listing flic) the macro lines that 

Description: Nonnfy^“ ircctlvc only the macro invocation line Is listed All 

generate code. If. listed, even if it generates code. .NOLISTUAcao is the 

Other macro expansion is not 

same as the sall directive. 
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NOL0CALS: Disable Local Symbols 

Applicable assembler*: TASM 2.0, TASM 3 0 
Directive category; Pro: rdurct and code label* 

Syntax i 
N0L0CAL8 

Description: Normally, TASM treau any symbol that begins with the characters @((jj 
as a local symbol You can change that with the LOCALS directive, or completely turn 
off local symbol recognition with this directive. 


%NOMACS: List Only Macros that Generate Code 

Applicable aascmblcra: TASM 2.0, TASM 3 0 
Directive category: Listing control 

Syntax: 

VJ0UAC8 

Description: If you use macros a great deal, you probably will use this directive also. 
It results In the expansion (listing) only of macros that generate code It is the same 
as the .xall directive. 


NOMASM51: Disable MASM 5.1 Compatibility 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Global control 

Syntax: 

MOUASliei 


Description: Normally TASM Is not 100% compatible with MASM S. l. For Instance. 
TASM does not understand some directives, and the backslash (\) line-continuation 
’ character does not work. Ifyou need these capabilities, you can use the maims: 
directive to ensure 100% compatibility. Ifyou later decide you no longer need the 
compatibility, use the N0MA8M81 directive. 
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NOMULTERRS: Disable Multiple Error Reporting 

Applicable assemblers: TASM 2.0, tASM 3.0 
Directive category: Global control 
Syntax: 

NOMULTERRS 

Description: This Is the default condition for error reporting. Typically, the 
assembler flags and reports only the first error it finds on each source<code line. Hie 
effects of this directive can be reversed with the multerrs directive. 


NOSMART: Disable Code Optimization 

Applicable assemblers: TASM 3.0 
Directive category: Gldbal control 
Syntax: 

NO SMART 

Description: If you want to disable any optimization that TASM normally may do, 
use this directive. To cum on optimization, use the SMART directive. SMART b the 
normal assembly condition for TASM. 


XNOSYMS: Disable Symbol Table in Listing File 

Applicable assemblers: TASM 2.0, TASM 3*0 
D ir ect i ve category: listing control 
Syntax: 


NN0SYMS 


___ Norma uv taSM generates a symbol table when a Listing file b 

delude the symbo. able, you c» a* this dUrcUv,. 
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%NOTRUNC: Control Word-Wrapping in the Listing File 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

V40TRUNC 

Description: Normally, 1/ the source-code lines or the generated code In the listing 
file are too long to be listed property, the code is truncated. This truncation occurs 
only in the listing flic*—not in the OBJ file. This directive rums off the truncation and 
causes the long elements to wrap to the next Une in the file. Alternatively, you can 

use the SB in and htext directives to change the field widths so that truncation is not 
necessary. 


NOWARN: Disable Warnings 

Applicable assemblers: TASM 2 0, TASM .10 
Directive category: Global control 

Syntax: 

NOWARN | elSSS) 

Description: Normally, TASM displays warnings as they occur during assembn 
Sometimes, however, you may want to rum off some or all of the warning messages. 
If you provide a warning clast, this directive will suppress warning messages in that 
das-. If you provide no parameters, all warning messages a.e suppressed. 

The warning classes are as follows: 


Class 

Meaning 

ALN 

Segment alignment 

ASS 

Assume segment is 16-bit 

BRK 

Brackets needed 

ICG 

Inefficient code 

LCO 

Location-counter overflow 

OP! 

Umerminated (open) IF condition 

OPP 

Unclosed (open) procedure 
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Class 

Meaning 

OPS 

Unclosed (open) segment 

OVF 

Arithmetic overflow 

PDC 

Pass-dependent coding 

PRO 

Incorrect protected-mode memory write 

RES 

Reserved word infraction 

TP I 

Illegal Turbo Pascal operation 


OPTION: Set Assembler Processing Parameters 

Applicable assemblers: MASM 6.0 
Directive category: Global control 
Syntax: 

OPTION argument ], argument] ... 

Description: MASM 6.0 enables you to control, in a global fashion, the way the 
assembler does its work. When you use the OPTION directive, you specify a series of 
arguments that define how the assembler should treat your source code from that 
point forward. Valid arguments are as follows: 

Argument Meaning 

Defines how MASM treats upper* and lower* 
case letters In symbols. Valid type arguments 
are NONE, NOTPUBUC, and ALL. 

Enables use of periods as leading characters 
In symbols. 

Assumes that floating-point instructions 
will be done by an emulator linked to the 
program. 

Instructs assembler to use the macro named 
macro to generate procedure epilogue code, 
rather than the regular epilogue. 

Sets the expression word size to 16 bits. ^ 

Sets the expression word size to 32 bits (the 
default). 


CASEMAP:fype 

DOTNAME 

EMULATOR 

EPlLOGUE-.macro 

EXPR16 

EXPR32 
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Argument 

t 

Meaning 

LANGUAGE 

Sets the default language type. Valid lang 
choices are C, Pascal, FORTRAN, BASIC, 

SYS CALL, or STDCALL. This argument sets 
what the default language Is if not specified In 
the .model directive. 

LJMP 

Enables smart processing of conditional 
lumps; handled In TASM by the jumps 
directive. 

M5I0 

Ensures complete compatibility with 

MASM 5.10. 

NODOTNAME 

Disables use of periods as leading characters 

In symbols. 

NOEMULATOR 

Generates floating-point instructions to work 
with numeric coprocessors (the default 

NOKEYWORD: <list> 

setting). 

Disables Individual reserved words. Reserved ^ 

words in the list must be separated by spaces, 
and the entire list must be enclosed in angle 
brackets (<>). 

NOtJMP r 

Disables smart processing of conditional 
jumps; handled in TASM by the N0JUMP9 
directive. 

NOM510 

Default operating condition for MASM 6.0; 
opposite of the M510 argument. 

NOOLDMACROS 

Handles macros according to hew rules for 
, MASM 6.0 (the default setting). 

NOOLDSTRUCTS 

Treats structure members according to new 
rules for MASM 6.0 (the default setting). 

NOREADONLY 

Normal error handling; allows any access of 
segments (the default condition). 

NOSCOPED 

Labels inside procedures are available outside 
the procedure. 

NOSIGNEXTEND 

m 

Uses non-sign-exrended opcodes for AND, 

OR, and XOR instructions. 

OFFSET:#>pe 

Specifies how offset instructions should be 
handled. Valid type options are SEGMENT, 

GROUP (the default), and FLAT. 

oldmacros 

Handles macros as was done in MASM 5.10. 
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Argument 

OLDSTRL'CTS 
PROC. visibility 

t 

PROlOGVEmacro 

READONLY 

SCOPED 

SEGMENTS* 


Meaning _ 

Treats structure members as in MASM 5.10. 

Sets default procedure visibility (normally 
PUBLIC) to PUBLIC, PRIVATE, or EXPORT. 

Instructs assembler to use the macro named 
macro to generate procedure prologue code 
rather than the regular prologue. 

Generates error If instructions are not read¬ 
only. Guarantees that segments will be read¬ 
only, which is necessary for OS/2 and code 
which will be written to and executed from 
ROM. 

Ensures that all labels inside procedures 
are local to the procedure (the default 
condition). 

Sets global default segment size. Valid choices 
are USE16, USE32, or FIAT. 


ORG: Specify Starting Segment Address 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Complete segment control 


Syntax: 

ORG address 

Dewrfption: 1/ you use the simplified segment duectives, you will no. n«d to 
use the 0A0 directive. It Is intended for use with foe nonsimpllfied versions, and 
designed to indicate to foe assembler and linker where in memory foe segment 

should reside. 


%OUT: Output a String to the Screen 

Applicable assemblers: Mien,** <*** AMerab,er 2 «• MASM 5 *' MASM 6 °' 

TASM 2.0, TASM 3 0 

Directive category: Miscellaneous 
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Syntax: 

SOUT text 

Description: This directive is used to display a text string to the video monitor 
during'assembly. It does not result in any code being generated, nor does it take 
memory in the generated file. 

You can use this directive to aid in debugging, so that you can see immediately 
when certain conditional instructions are being assembled. Similar functions are 
provided by the display and ECHO directives. 

Example: 


%0UT Now ?dding debug routines 



P186: Enable 80186 Programming 


Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Processor specification 
Syntax: 

Pi 86 

Description: This directive Is equivalent to the .186 directive. TASM allows you 
to program for specific microprocessors, the default being the 8086. This direc¬ 
tive causes the assembler to handle instructions compatible with the 80186 
microprocessor. 



P286: Enable 80286 Programming 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Processor specification 
Syntax: 

% 

P286 - . 

Description: This directive is similar to the .286 directive. TASM all 
to program for specific microprocessors, the default being the 8086 
live causes the assembler to handle instructions compatible with 
microprocessor. . . 016 
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This directive differs from the .236 directive in that, with this one. you can 
program for all modes of the 80286. whereas the .286 directive allows only 
nonprotected-mode programming. 


P286N: Enable 80286 Nonprotected-Mode Programming 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: Processor specification 
Syntax: 

P286N 

Description: This directive is functionally equivalent to the .286 and - 2 ®6C 
directives, and the opposite of the 286P and P286P directives. It is also more 

restrictive than the P286 directive. 

With this directive you can program for the 80286 processor but the assent- 
bier makes sure that you use no instructions that require protected mod . 


P286P: Enable 80286 Protected-Mode Programming 

Applicable assemblers: TASM 2.0. TASM 3-0 
Directive category: Processor specification 
Syntax: 

P286P 

Description: ^directive is equivalent* ^ 

program for specific microprocessors, the 80286 micropro- 

cauKSthe assembler to handle Instructions compatible^ ,hc8°286 micr p 

ccssor. including those instructions that require protected mode. 


P287: Enable 80287 Programming 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Processor specification 
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Syntax: 


P287 


Description: TASM enables you to take advantage of numeric coprocessors in your 
programs, the default being the 808^ NPX. This directive causes the assembler tc 
handle instructions compatible with the 80287 numeric coprocessor 


If you have used the .286, .286C, .286P, P286, P206N, or P286P 
the P287 directive is redundant and unnecessary. 


directives, using 


P386: Enable 80386 Programming 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Processor specification 
Syntax: 

P386 


Description: This directive is similar to the .386 dirwriv* tku .. 
program for specific microprocessors, the default being the 8086 OW * . you to 
causes the assembler to handle instmctions 
ccssor, including insuuoion, dm use the expand" 

This directive differs from the .386 directive in that wirh « 
program for all modes of the 80386 whereas th* h u ° nC> ^ 02X1 
nonprotected mode programming. '• < * trccUve allows only 



P386N: Enable 80386 Nonprotected-Mode Programming 

Applicable assemblers: TASM 2.0, TASM 3.0 ® 

Directive category: Processor specification 

Syntax: 


P366N 


Description: This directive is functionally equivalent to the 386 anH 

dyes, and the opposite of the .3eer and F 3 MP directives I, is'abomorem. J*'"’ 
than the P386 directive. morc restrictive 


w,th thts directive you can program for the 80386 processor but ,h 
bier makes sure that you use no instructions that require pro*ae d m^/ 
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P386P: Enable 80386 Protected*Mode Programming 

Applicable assemblers: TASM 2 0, TASM 3.0 
Directive category: Processor specification 
Syntax: 

P386P 

Description: This directive is equivalent to the . 386P directive. TASM allows you to 
program for specific microprocessors, the default being the 8086. This directive 
causes the assembler to handle instructions compatible with the 80386 micropro¬ 
cessor, including those that require protected mode. 


P387: Enable 80387 Programming 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Processor specification 
Syntax: 

P387 

Description: TASM enables you to take advantage of numeric coprocessors in your 
programs, the default being the 8087 NPX. This directive causes the assembler to 
handle instructions compatible with the 80387 numeric coprocessor. 

If you have used the .386, .386C, .386P, P386, P386N, or P386P directives, using 
the P387 directive is redundant and unnecessary. 



P486: Enable 80486 Programming 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Processor specification 
Syntax: 


P486 


Description- This directive is similar to the .386 directive. TASM allows you to 
program for specific microprocessors, ihe default being ihe 8086. This direciive 
causes the assembler to handle instructions compatible with the 80,86 micropro- 
cessor. including instructions that use the expanded register set of the 80486. 
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This directive differs from the .486 directive in that, with this one, you can 
program for all modes of the 80486, whereas the .486 directive allows only 
nonprotected-mode programming. 

Note that the P486 directive enables the use of instructions designed to take 
advantage of the NPX built into the 80486. If your code is designed to run ultimately 
on the 80486 SX chip, make sure not to use instructions that require the NPX. Even 
though the assembler will allow them (after this directive is executed), the resulting 
code will not run on the 80486 SX. 


P486N: Enable 80486 Nonprotected-Mode Programming 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Processor specification 
Syntax: 

P486N 

Description: This directive is functionally equivalent to the .486 and .486C direc¬ 
tives, and the opposite of the . 486P and P486P directives. It is also more restrictive 
than the P486 directive. 

With this directive you can program for the 80386 processor, but the assem¬ 
bler makes sure that you use no instructions that require protected mode. 

Note that the - :86N directive enables the use of instructions designed to 
take advantage of th/NPX built into the 8 O 486 . If your code is designed to run 
ultimately on the 80-»S6 SX chip, be sure not to use instructions that require the NPX. 
Even though the assembler will allow them (after this directive Is executed), the 
resulting code will not run on the 80486 SX. 



P8086. Enable 8086 Programming 

Applicable assemblers: TASM 2 0. TASM 3 0 
Directive category: Processor specification 
Syntax: 

P8086 
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Description: This is the default programming paradigm for TASM. This directive is 
equivalent to the .8086 directive. Although you can use other directives to enable 
various levels of processor compatibility, this directive can be used to make 
absolutely sure that your program will work with all members of the 80x86 family. 

A typical use of this directive is after you have been programming for a differ¬ 
ent level of compatibility (80286 or higher) and you want to make sure that your pro¬ 
gram will still assemble for use with older processors. 


P8087: Enable 8087 Programming 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: Processor specification 


Syntax: 

P8087 


Description: This is the default programming capability of TASM. This directive is 
equivalent to the .8087 directive. You can use this directive to state explicity in your 
program that you are programming for the 8087 numeric coprocessor, but use of 


the directive is not mandatory. 



PAGE: Listing-File Page Control 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.O. 
TASM 2.0, TASM 3-0 

Directive category: Listing control 

Syntax: 

PAGE (rowsll, columns) 


or 


PAGE ♦ 

A .a — ^ — A 1 m Vaii 

( 



control the size of the printed page in the listing file with this 
nal rows and columns parameters specify how deep and wide to 
page is issued with no parameters, the next line of the listing fil<* 
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I 


If you use a plus sign (+) after the page directive, you not only cause the listing 
file to jump to the top of a new page, but you also cause the section number to 
increment and the page number to be reset to 1. 


%PAGESIZE: Set Listing-File Page Dimensions 

Applicable assemblers: TASM 2.0, TA5M 3.0 
Directive category: Listing control 

(rows)!, columns ) 

Description: You control the size of the printed page in the listing file with this 
directive. The optional rows and columns parameters specify how deep and wide to 
print each page Alternatively, you can use the PAGE directive to do this task 


%PCNT: Set Listing-File Address-Field Width 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Listing control 
Syntax: 

VCNT width 

Description: When you have requested a listing file (LST file) during assembly, dlls 
directive controls the width of the offset address field. The default width is 4 for 16- 
bit segments and 8 for 32-bit segments, but you can set it to any reasonable value. 



PN087: Disable Numeric-Coprocessor Programming 

Applicable assemblers' TASM 2.0, TASM 3-0 
Directive category: Processor specification 
Syntax: 

PN087 


l 
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Description: By default, TASM enables you to program for the 8087 numeric 
coprocessor. You can use any of the other processor directives to enable varying 
levels of NPX compatibility. This directive, on the other hand, disallows all program¬ 
ming for a numeric coprocessor. If you know that you are programming for an 
environment with no coprocessor chip, you can use this directive to make abso¬ 
lutely sure that no incompatible code will be in your program. 


POPCONTEXT: Restore Assembler Environment 

Applicable assemblers: MASM 6.0 
Directive category: Global control 
Syntax: 

P0PC0NTEXT. condition 

t 

Description: This directive generally is used in macros to restore assembler set¬ 
tings saved with the PUSHCONTEXT directive. The condition can be the following: 


Condition 

Meaning 

ASSUME 

Current segment register assumptions 

CPU 

State of current CPU and processor directives 

LISTING 

State of listing and cross-reference directives (similar 
to the SPOPCTLS directive for TASM) 

RADIX 

Current default radix 

ALL 

All of the above 


If you try to restore something that you have not previously saved, or if you 
attempt to restore more than you previously saved, the assembler generates an error. 


%POPLCTL: Restore Listing Controls 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: listing control 
Syntax: 

VOPLCTL 
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Description: Using this directive allows you to restore the condition of the %MACS. 
%LIST. and SINCL directives previously s_"ed with the %PUSHLCTL directive. 

If you use MASM 6.0. you can use the Pl.'-context directive to accomplish this 

task. 



PROC: Start a Procedure 

Applicable assemblers: Microsoft Quick Assembler 2 51. MASM 5 1 MASM 6 0 
TASM 2 0. TASM 3 0 

Directive category: Procedures and code labels 
Syntax: 

label PROC (attributes) (USES realist)(, variable[:type] 

(, variable] : type) ...J(, arpftVARARG] 

or. if you are using TASM:, • 

label PROC (attributes) . • 

or. if you are using TASM in ideal mode: 

PROC label ( attributes ) 

v. h-re attributes has the following construction: 

Id stance | ((langmod ]language] [ visibility) ( <prologuearg>] 

i ,f cri P* io “ : usc of ' he M0C varies widely, depending on how many 

bells and wh.siles you include and which assembler you are using. Note however 
•hat only the label and the PROC directive are required. 


The label is the symbolic name you use to refer to the procedure. The distance 
controls the way the RET at the end of the procedure functions It 

or FAR. and serves .0 override the default distance defined by the . model or model 



„, c , MUUtL or mooel directive It 
oUow ing. depending on your assembler: 



can be any one of the 
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Language 


\L\SM TASM 


BASIC 

C 

CPP 

FORTRAN 

NOLANGUAGE 

Pascal 

Prolog 

STD CALL 

SYSCALL 


X X 

X X 

X 

X X 

X 

X X 

X 
X 
X 


The visibility, available only with MASM 6.0. can be PRIVATE, PUBLIC, or 
EXPORT. Abo available only with MASM 6 0 is the prologuearg parameter, which 
controls the way the assembler generates the prologue and epilogue. Valid options 
here are LOADDS. which assigns and restores the DS register, and FORCEFRAME. 
which forces MASM.to create a stack for the procedure. Notice that the prologuearg 
options must be enclosed In angle brackets (< >)• 

If your procedure uses registers whose contents you do not want the routine 
to modify, you can use the USES keyword and specify a register list, reglist. Regis¬ 
ters to be pushed in the prologue and popped in the epilogue should be listed with 
only one space between them. Note that if you are using TASM. the USES keyword is 
actually a directive and is handled differently. See the USES directive for more 
information. 

If you are using MASM 6.0. you can specify an argument list on the PROC line. 
This list consists of the variable name and any valid type specification for the 
variable, such as BYTE, WORD, etc Note that this is different from the way 
arguments were specified before MASM 6 0, and from the way they continue to be 
specified with TASM. This argument list capability was implemented with the arg 
directive, to which you may want to refer for more information. 

Abo MASM 6 0 enables you to build procedures for a variable number of 
arguments. This is done by using the vararg keyword at the end of the PROC 
declaration, where argi b the name of the first argument All other arguments are 
then accessed as offsets from this first one. Note that vararg is applicable only if you 
are using the C, SYSCALL, or STDCALL language calling conventions 
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PROTO: Declare Procedure Prototype 

Applicable assemblers: MASM 6 0 


Directive category: Prom lures and code label* 

# 

Syntax: 

label PHOTO l distance] | languaye\\, veri»ble[ i type | 

(• varleble[:type\ ...)(, aryl :VAHAHGJ 

Description: Prototypes in MASM 6.0 function In ihc umc manner as prototypes in 

wi» look fr* C ' M Cy *T d , Cil * ncd ’° ,h; “ y° u «n declare what the real procedure 
will look like, without having to write the actual procedure 

The 1 ^rr"" h rr , 0‘ llrCUl " *• «<"c as (dr the PMC directive 

he label Is the symbolic name you use to refer to the procedure. The distance 

or FAR and *** lhC RET * Cnd ° f *** P rocedurc Unctions. It can be cither NEAR 

or ZXcZll ' 0 “ C thc dcft,uh d,stancc ’ ^ * d '«- d br *e. JSS 

# 

With th h e^r £ roV:Sf C d;r«,“e U ^e“r rr,dC ^ r jul ‘ h « * defrned 

you can with the PROC dfreettaTbis list consists of! tT"™ ' he , ' UI ' <r manncr •*“* 

«yp. specification for the ^ “ d 

You can use the vararg keyword also ro «io«iA, »u . .u 

triable number of arguments. This is done with tte VAMUta^rf"* ^ T * 
the PROC declaration, where argi is the name of ,1. e “Twonl at the end of 

arguments are then accessed as oflsets from thu one ^® Ume "‘ 411 0<her 

applicable only If you are using the C. SYSCAU or STDCALj°ia ‘ h “ VA ***° “ 
conventions. » ilk-ALL language calling 


PUBLIC: Declare Symbols as PUBLIC 

Applicable assemblers: Microsoft n..ir.i, a 

TASM 2.0, TASM 3 0 Q k A ** embler 2 *L MASM 5.1, MASM 6.0, 

Directive category: Scope and visibility 
Syntax: 

PUBLIC | language IsyWoj,. 
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^if This directive allows you to specify how symbols in your program 

w seen by other modules. This specification is necessary at link time, when 
externals must be resolved. 

The language specifier is used to override the default language, which is set 
with the .MOOEL or MOOEL directives. The language can be one of the following, 
depending on your assembler: 


Language _ MASM TASM 

BASIC * x X 

C XX 

CPP X 

fortran x x 

NOLANGUAGE X . 

Pascal x X 

Prolog X 

STDCALL X 

SYSCALL X 


The symbol is the name of a procedure or some other label that is defined in 
the module. 


PUBUCDLL: Declare Symbols as PUBLIC for 
Dynamic Link Libraries 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Scope and visibility 
Syntax: 

PUBLICOLL [language ] symbol [, (language ]symbol] ... 

Description: This directive is a special version of the public directive, for use with 
OS/2 and Windows dynamic link libraries (DLL). The language specifier is used to 
override the default language, which is set with the . MOOEL or MOOEL directives. Valid 
choices for language are BASIC, C, CPP. FORTRAN, NOLANGUAGE, Pascal, or Prolog. 
The symbol is the name of a procedure or some other label that is defined in the 
module. 
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PURGE: Delete Macro Definition 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Macros and repeat blocks 
Syntax: 

PURGE label [, label] ... 

Description: After a macro has been defined, it remains in memory until you use 
this directive to remove it. PURGE accepts, as label, the name of previously defined 


macros. 



PUSHCONTEXT: Save Assembler Environment 


Applicable assemblers: MASM 6.0 
Directive f ategory: Global control 
Syntax: 

PJJSHCONTEXT condition 


Description: This directive generally is used inside macros to save current assent 
bier settings temporarily. The condition can be the following: 


Condition 


Meaning 


ASSUME 

CPU 

LISTING 


Current segment register assumptions 

State of current CPU and processor directives 

State of listing and cross-reference directives (similar to 
the V>USHCTLS directive for TASM) 

Current default radix 

All of the above 


RADIX 

ALL 


The stpred settings can be restored by using the P0PC0NTEXT directive 
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%PUSHLCTL: Temporarily Save Listing Controls 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

%PU$HLCTL 

Description: Using this directive allows you to save the condition of the %MACS, 
%LIST, and %INCL directives. You can restore them laterwith the %P0PLCTL directive. 

If you use MASM 6.0, you can use the pushcontext directive to accomplish this 

task. 


QUIRKS: Enable Handling of MASM Quirks 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Global control 
Syntax: 

QUIRKS 

Descriptioh: MASM has some odd behavior that TASM normally will not tolerate. 
When you use this directive, you are instructing TASM to behave exactly as MASM 
does, regardless of whether it makes logical sense. If your code takas advantage of 
some of the documented quirks in MASM, you should rewrite the code so that it 
will work properly under both assemblers. If you want more information on exactly 
what the MASM quirks are. you should refer to the Turbo Assembler manual. 



QWORD: Allocate a Quadword of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

[label) QWORD expression, expression] 
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Description: This directive is equivalent to the OQ directive. It is used to allocate 8 
bytes of memory (a quadword) for data storage in the executable file. Typically, this 
data size is used for 8-byte integers used with numeric coprocessors. The label is a 
user-defined name that you can use later to refer symbolically to the stored 
information. Each expression must be one of the following: 

□ A number between -2 65 and 2 64 -l 

□ A formula resolving to a number between -2 65 and 2 64 -l 

□ A 64-bit floating-point number between ±2.23 x 10' 308 and ±1.79 x 10 30 * 

Q A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the QWORD directive is longer than a single quadword, 
the label refers only to the first quadword of the allocated data. ~ 4 

You can use the reals directive for floating-point numbers also. •• 
Examples: 

Values QWORD 12345.678S, 987.6543 * 

MemArea QWORD 1024 * 64 * 4 

Array QWORD 12 DUP(?) 


.RADIX: Specify the Default Radix *. »•* 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5 1 MASM 6 0 
TASM 2.0, TASM 3.0 ’ 

v * * 

Directive category: Global control 

Syntax: * 

.RADIX setting 

Description: The default radix for the assembler is decimal (all numbers are 
assumed to be decimal, unless an override radfic is used), but this directive allows 
you to change the radix. Valid sattlnos are 2, 8,10, and 16. 

If you are using TASM, you can use the RADIX directive also. 
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RADIX: Specify the Default Radix 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Global control 
Syntax: 

RADIX Sitting 

Description: This directive is the same as the . RADIX directive. The default radix for 
the assembler is decimal (all numbers are assumed to be decimal, unless an override 
radix is used), but this directive allows you to change the radix. Valid settings are 
2, 8, 10, and 1$. . 


REXL4: Allocate a Doubleword of Storage Space for 
a 32-Bit Floating-Point Number 

it* w 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 

< 

-... Syntax: * 

l label] REALS expression], expression] 

i 

Description: This directive allocates 4 bytes of memory (a doubleword) for data 
storage in the executable file. In this way, it is similar to the DO and DWORD directives. 

It also assumes that the content^ of this memory area will be 32-bit floating-point 
values. 

»* / 

The label is a user-define name you can use later to refer symbolically to the 
stored information. Each expression must be one of the following: 

Q A 32-bit floating-point number between ±1.18 x 10 38 and ±3-40 x 10 38 

□ An expression that resolvesto a 32-bit floating-point number between 
±1.18 x 10' 38 and ±3.40 x 10 J8 < ' . 

f 

Q A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

a 

If the data allocated by the REALS directive is longer than a single doubleword, 
the labtl refers only to the first doubleword of the allocated data. 
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There is effectively no difference between floating-point numbers generated 
with this directive and those generated with DD or DWORD. The practical difference is 
apparent, however, when you use CodeView to debug your code. Ifyou use the REAL4 
directive, CodeView knows how to treat and display the numbers. 

Examples: 

Valuel REAL4 98765.432987 

values , REAL4 2.345, 59.682 
Array REAL4 50 DUP(^) 


REAL8: Allocate a Quadword of Storage Space for 
a 64-Bit Floating-Point Number 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

[label] REALS expression], expression] 

Description: This directive allocates 8 bytes of memory (a quadword) for data 
tora gt m the executable file In this way. i, is similar to the oa and OWORO directives 
values “ SUm “ a ' conKnts ofthis niemory area will be 64-bit floating-point 

The label is a user-defined name you can use later to refer symbolically to the 
stored information. Each expression must be one of the following: **) 

□ A 64-bit floating-point number between ±2.2} x 10and ±1.79 x 10 3 " 

Q 64 - bit noa,ingp ° int numb ‘ r 

□ A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple ocn.™.— t 
the data in the expression. K 7 ,p,e occurrenc cs of 

If the data allocated by the REALS directive is longer than asinelr . w 

label refers only to the first quadword of the allocated data. ^ <|Uadword - th ' 

. . TherC ,S effcctivc *y no difference between floating-point nnmk. 
with this directive and those generated with DO or QWORD. The nra«- ” £ encratc ^ 

apparent, however, whenyouuseCodeViewtodebugyourcrvHaa if difference is 

directive, CodeView knows how to treat and display the numbe die REAL8 
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Examples: 


valuei 

values 

Array 


REALS 13/3 

REALS 465825432.345, 508543249.682 
REALS 50 DUP(?) 


REAL10: Allocate 10 Bytes of Storage Space for 
an 80-Bit Floating-Point Number 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

[label] REAL 10 expression[, expression\ 

• 

Description: This directive allocates 10 bytes of memory for data storage in the 
executable file. In this way, It is similar to the 0T and T*0RD directives. It also assumes 
that the contents of this memory area will be a temporary 80-bit floating-point value. 

The label is a user-defined name you can use later to refer symbolically to the 
stored information. Each expression must be one of the following: 

Q An 80-bit floating-point number between ±3 37 x lO"* 932 and ±1.18 x 10 4932 

□ j\j\ expression thax resolves to in 80-bit floating-point number benveen 
±3.37 xl<T” 2 and ±l.l«xlO w2 

Q a question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the REALii directive is longer than 10 bytes, the label 
refers only to the first 10 bytes of the allocated data. 

There is effectively no difference between floating-point numbers generated 
with this directive and those generated with DT or TVtORO. The practical difference is 
apparent, however, when you use CodeView to debug your code. If you use the 
REAL 16 directive, CodeView knows how to treat and display the numbers. 

Examples: 

Valual REALii 123456789 / 987612345 

Valuas REALii 465825432.345, 508543249.682 

Array REALii 5i DUP(?) 
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RECORD: Define Records 

S??^‘V“ emb,e ” : Microsoft Q uick Assembler 2.51. MASM 5.1. MASM 6.0 
I ASM 2.0, TASM 3 0 

Directive category: Complex data types 
Syntax: 

• ~ -- * 

label RECORD l fiel<j [, fi 0ld] ... j 

or, if you are using TASM in ideal mode: 

RECORD label [fieldl, field ) ...) *? 

where each field has the construction: 

fieldlabel:width[*value] 

Description: This is a user-defined data type composed of a number of bit fields that 
collected) add up to a complete record. The label is the symbolic name for the 
record. Each bit field has a symbolic field name, fieldlabel. and a width, in bits. 
Optionally, you can assign a value to each bit field. 

of, h -.'I, yOUr reCOr u d ' fini,i ? ns 8«>w quite large, you can use the multiline version 
L *e ascnan A 6 ' s ‘ m P'r roqalres that you place a left brace ({) on the same line 

° Th ‘ ngenC0Un " red “ P “ a fi * ht bra “ 0) is considered 



REPEAT: Declare the Beginning of a Controlled Loop 

Applicable assemblers: MASM 6.0 


Directive category: Control flow 
Syntax: 

•REPEAT 

Description: This directive is used to eliminate the need for the programmer to 
determine the best way to construct a repetitive loop. The .repeat directive which 
is similar in construct to the DO loop in C or the REPEAT loop in Pascal is a contim.ina 
attempt to build higher-level functionality into assembly language. ^ 

Loops that use .repeat can be nested with other loops that use rppcat 
.WHILE. These loops also can be terminated normally with the .UNTIL or untti r?* 
directives, or prematurely with the .break or .cont inje directives * u " riLCXZ 
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Do not confuse the .REPEAT directive with the REPEAT directive; they have 
different purposes and actions. 

Example: 


.REPEAT 


;walt for ESC key to be pressed 

MOV 

AH, 7 

;0irect character input without echo 

INT 

2th 

;DOS services _ 

.UNTIL 

(AL ■» 27) 

;Keep going until ESC is pressed 

This example is the same as the following nondirective method of coding the 

loop: 

InLoop: mov 

AH,7 

;0irect character input without echo 

•> y INT 

21h 

;00S services 

CMP 

AL.27 

;Was ESC key pressed? 

JNE 

InLoop 

;No, so do it again 


REPEAT: Repeat a Block of Instructions 

Applicable assemblers: MASM 6.0 
Directive category: Macros and repeat blocks 
Syntax: 

REPEAT txprission 

Description: This directive is the same as the REPT directive. It provides a way for 
the assembler to repeat a code block several times. Typically, this directive is used 
In macros. 

The expression represents the number of times the code block and/or 
Instructions should be repeated. Every source-code line between the REPT directive 
and the ENDM or exitm directives is repeated this number of times. 

Example: 

DataSet MACRO Times 

.ERRB <Timea» ;Need to have an argument 

BufrTable DW Times OUP (6) 

REPT Times 
DB 512 DUP (?) 

ENOM 

ENOM 


r 
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REPT: Repeat a Block of Instructions 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6 0 
TASM 2.0, TASM 3.0 

Directive category: Macros and repeat blocks 
Syntax: 

REPT expression 

Description: This directive provides a way for the assembler to repeat a code block 
several tunes. Typically, this directive is used in macros. 

The expression represents the number of times the code block and/or 

.*■* sou r codeb ™ £ 

ana tne endu or exit* directives is repeated this number of times. 

If you are using MASM 6.0, you can use the REPEAT directive also. 


;Need to have an argument 


Example: 



OataSet 

UAcr* 

Times 


. ERRB 

<Times> 

BufrTaule 

DW 

Times 0UP ( 0 ) 

• 

REPT 

Times 


DB 

512 0UP (?) 


END* 



Enow 



.SALL; Disable Macro Listing 


Applicable assemblers: Microsoft Quick Assembler 2 51 macm c , 

TASM 2.0, TASM 3 0 51, 3.1, MASM 6.0, 

Directive category: Listing control 

Syntax: 

.SALL 

Description: Normally, the assembler lists (in the Usrino fil % 
generate code. If you use this directive, only the mar™ 8 3 the macro J,ncs that 

other macro expansion is listed, even if « generates Une ** ,isied No 

the same as the .nOLISTmacro directive. ° 0c ' ^ ndcr MASM 6.0, this is 
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SBYTE: Allocate a Signed Bvte of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

llabel] S8YTE expression), expression) 

Description: This directive is similar to the 08 and byte directives. It is used to 
allocate memory in the executable file for data storage. The label is a user-defined 
name you can use later to refer symbolically to the stored information. Each 
expression must be one of the following: 

□ A number between -128 and 127 

□ A formula resolving to a number between -128 and 127 

Zl A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the SBYTE directive is longer than a single byte, the 
label refers only to the first byte of the allocated data. 

Examples: 


Valuei 

SBYTE 

0 

Value2 

«BYTE 

CO 

CO 

• 

BoxSize 

SBYTE 

5 • 7 

Array 

SBYTE 

200 DUP(?) 

TruthTable 

SBTYE 

8 DUP( • 128) 


SDWORD: Allocate a Signed Doubleword of 
Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

(label] SOWORD expression), expression) 
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Description: This directive is similar to the DO and DWORD directives. It is used to 
allocate 4 bytes of memory (a doubleword) for data storage in the executable file. 
The lacel is a user-defined name you can use later to refer symbolically to the stored 
information. Each expression must be one of the following: 


□ A number between -2,147,483,648 and 2.147,483,647 

□ A formula resolving to a number between -2,147,483,648 and 
2,147,483,647 

£3 A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DL'P operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the SDWORD directive is longer than a single doubleword, 
the label refers only to the first doubleword of the allocated data. 

Examples: 

Values SDWORD :24565, 67845, 0, -99253665 

Counter SDWORO 0 

MemArea SDWORD 1024 • 64 • 4 

Array SDWORD 100 0UP(?) 


SEGMENT: Define Beginning of a Segment 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5 1 MASM 6 0 
TASM 2.0, TASM 3.0 

Directive category: Complete segment control 
Syntax: 

label SEGMENT [align] (attributes) ( class') 
or, if you are using TASM in ideal mode. 


SEGMENT label (align) (attributes) l'class') 

Description: This is the nonsimplified method of designating the beeinninn of a 
segment. Used in conjunction with the ENDS directive, segment marks what the 
assembler and linker should include in a specific segment. 


The label can be any symbolic name you want the segment to use. The alion 
parameter species how the segment should be aligned: BYTE, WORD DWORD 
PARA, or PAGE. If you are using TASM, you can use MEMPAGE as an .U 8 n type*** 
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The attributes can be a combination of the following: 


Attribute 

AtASM 

TASM 

Meaning 

PRIVATE 

X 

X 

Segment will not be combined with 
other segments outside this module, 
even if they have the same name. This 
is the default attribute. 

PUBLIC 

X 

X 

Segment will be combined with other 
segments (outside this module) with 
the same name. 

MEMORY 

X 

X 

Same as PUBLIC 

COMMON 

** 

X 

X 

Causes segments of the same name to 
share the same memory space. Ail 
such segments begin at the same 
memory address. 

STACK 

X 

9 

Combines ail segments having the 
same name, and causes the operating 
system to set SS OO to the start of this 
segment and SS:SP to the top of it. 

READONLY 

X 

X 

Segment cannot be modified. Assem¬ 
bler will generate an error if it detects 

*' 

• 


information being changed in the 
segment. 

READ WRITE 


X 

Segment can be accessed normally. 

EXECONIY 


X 

Segment contains only executable 
code. Assembler will generate an 
error if it detects any other type of 
access. 

EXECREAD 


X 

Segment can be executed and read 
from, but not modified. Assembler 
will generate an error If it detects any 
other type of access. 

VIRTUAL 


X 

A child segment attached to and 
enclosed in any other type of 
segment. 

AT para 

X 

X 

Specifies that the segment should 
begin at the specified paragraph 
address. 

USE 16 

X 

X 

Use 16-bit word size (offset address¬ 
ing) if using an 80386 or 80486. 
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Attribute MASM 

TASM 

Meaning 

LSE32 X 

X 

Use 32-bit word size (offset address¬ 
ing) if using an 80386 or 80486. 

FLAT X 

X 

Don't use segmentioffset notation. 


Vou can specify an optional class type, enclosed in single quotation marks 
(apostrophes), ifyou want to dictate how the linker should combine this segment 
with other segments Segments are ordered first by group and then by name. 

Segments having the same name but belonging to different groups are never 
combined^ * 


•SEQ: Place Segments in Sequential Order 

TASM^o't^mTo 1 '” 1 MiCrOSOft QUiCk A5Wmbler «»• MASM 5 1, MASM 60. 

Directive category: Complete segment control 
Syntax: 

.SeO 

Description: Normally: both MASM and TASM place segments in the obi ru • 
the order in which they are encountered in the sourr* fiu c ^ 0B -* ln 
purpose of this direct, using * *° *' 

^ “SSEG and 

dire ctive. 8 ASM - * h,s dlrec, ' v * is equivalent to the SEO 



SEQ: Place Segments in Sequential Order 

Applicable assemblers: TAS.N 1 3.0 

Directive category: Complete segment control 
Syntax: * 

SEO • • 


Description: Normally, both MASM and TASM n i 

the order in which they are encountered m thc OB J We in 

purpose of this directive, using seo is redundant wdunnece^^ ^ thc 
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You can affect the ordering of segments with the .alpha, alpha, .OOSSEG, and 
DOSSEG directives also. 


This directive is equivalent to the .SEQ directive. 


.SFCOND: List True Conditional Statements 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Listing control 

Syntax: 


.SFCOND 

Description: Instructs the assembler to include conditional cole in the lisung file 
only if it is a true condition. In other words, onlv code that makes it to the OBJ i e 
is listed. If you are using TASM, this directive is the same as the SN0C0NDS directive. 
Under MASM 6.0, this is the same as the .NOLISTIF directive. 


SIZESTR: Return the Length of a String 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 6.0, TASM 2.0, 
TASM 30 

Directive category: String control 
Syntax: 


label SIZESTR string 

Description: This directive functions much like its counterpart in some high-level 
languages. When assembled, it assigns to the text macro label the length of string. 
For instance, the following statements: 

VerDate TEXTEQU '10/13/1991' 

VDLen SIZESTR Verdate 


result in VDLen being equal to 10. 
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SMALLSTACK: Specify 16-Bit Stack Pointer 

Applicable assemblers: TASM 3 0 


Directive category: Global control 
Syntax: * 

SMALLSTACK 


^sS cn„ ^T y ' ' Pr °'T e lnd epUogue code *"'"*'* automatically 
byTASM controls the way a procedure uses the stack. If you are using an 80386 or 

80*86. however, it is possible to use either a 16-bit or 32-bit stack o“mer Thu 
dureeuwr overrides the default stack size selected with the .model or uoSecrtve 
and ensures that a 16-bit pointer is used. 


SMART: Enable-Code Optimisation 

Applicable assemblers: TASM 3.0 
Directive category: Global control 
Syntax: 

SMART 

Description: TASM normally optimizes code to operate the quickest wav Dossihlr 
in the least amount of memory If you use the nosmast directive to turn off 
optimization, you can use this directive later to return to the default. * 


.STACK: Define Beginning of Stack Segment 

^ P m"o , T*smTo' C " : M,trOSOft QUiCk ““ bb - 51 ' MASM 5 1. MASM 6.0. 

Directive category: Complete segment control 
Syntax: 

.STACK (sire) 

Description: This directive causes the assembler to create a stack sccmenr f 
bytes. If no slat is specified, a default suck of 1.024 bytes is created^ f 


size 
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Typically, you need to create a stack only if you are writing stand-alone 
assembly language programs. If you arc writing routines for use with high-level 
languages, the linker allows you to use the same stack used by the high-level 
language. 

Alternatively, if you are using TASM, you can use the STACK directive. 


STACK: Define Beginning of Stack Segment 

Applicable assemblers: TASM 2.0, TASM 3-0 
Directive category: Complete segment control 
Syntax: 

STACK (sirs) ft. 

Description: This directive is the same as the .stack directive. It causes the 
assembler to create a stack segment of size bytes. If no size Is specified, a default 
stack of 1,024 bytes is created - 

Typically, you need to create a stack only If you are writing stand-alone 
assembly language programs. If you are writing routines for use with high-level 
languages, the linker allows you to use the same stack used by the high-level 
language. 


.STARTUP: Specify Program Entry Point 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Simplified segment control 
Syntax: 

.STARTUP 

Description: .startup, one of the simplified segment directives, should be used 
with the .EXIT directive, .startup enables you to specify the entry point of your 
program. Then the assembler automatically generates code that sets up the envi¬ 
ronment of your program to be consistent with the environment you specified with 
the .model directive. When your program is complete, this pork is “cleaned up” by 
the code generated by .EXIT. 

Place this directive in the main module of your program, immediately follow¬ 
ing the . COOE directive. 1 
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STARTUPCODE: Specify Program Entry Point 

Applicable assemblers: TASM 3.0 


Directive category: Simplified segment control 
Syntax: 

STARTUPCODE 

Description: This directive is the same as the .STARTUP directive. One of the 
simplified segment directives, It should be used with the EXITCODE directive. 
STARTUPCODE allows you to specify the entry point of your program. Then the 
assembler automatically generates code that sets up the environment of your 
program to be consistent with the environment you specified with the .MODEL or 
MODEL directives. When your program is complete, this work is “cleaned up" by the 
code generated by EXITCODE. 

Place this directive in the main module of your program, immediately follow¬ 
ing the . CODE directive. 


STRUC: Define a Data Structure 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5 1 MASM 6 0 
TASM 2.0, TASM 3 0 ' ’ * 

Directive category: Complex data types 

Syntax: 


label STRUC (align)[, NONUNIQUE] 
or. if you are using TASM in ideal mode: 


STRUC label 

Description: Similar to user-defined data structures in high-level languages the 
STRUC directive enables you to specify the beginning of a data structure The data 
definition directives that follow, until the next ENOS directive is encountered 
the members of the structure. Members of the structure can be anv data-definition 
directive you want; they do not have to be similar in type. The data « 11 
collectively will be known by the symbolic name label. 


If you are using MASM 6.0, you can specify an alignment value ali Qn wh.rh 
is used to align members of the structure within memory. Valid values ar^i ^ 
If you specify align, the amount of space taken by the structure may increa^but 
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so will the speed with which members of the structure can be accessed. This applies 
only to 16- or 32-bit processors. 

t . 

Also, the NONUNIQUE parameter specifies how stringent the assembler is in 
allowing subsequent references to members of the structure. If you use this 
parameter, you must provide a full structure and member name each time you want 
to reference a member. 

Alternatively, if you are using MASM 6.0, you can use the STRUCT directive to 


define data structures. 


Example: 




PayRecord 

STRUC 



LastName 

OB 

IS 

DUP (0) 

FirstName 

OB 

15 

0UP (0) 

Address 

D8 

30 

DUP (0) 

City 

DB 

25 

DUP (0) 

State 

OB 

« 

’.0 

ZipCode 

DB 

10 

DUP (0) 

BasePay 

REAL4 

0 


Commission 

REAL4 

0 


Hireuonth 

DB 

• 

1 

HireOay 

OB 

• I 

• *• 

HireYear 

OB . 

• . 

’ »• 


ENOS 




STRUCT: Define a Data Structure 

1 ♦ 

# . 

Applicable assemblers: MASM 6.0 

Directive category: Simplified segment control 

Syntax: 

label STRUCT lalign)[, NONUNIQUE] 

Description: This directive, which is the same as the STRUC directive, is provided so 
that the many C programmers using MASM can comfortably spell the directive in 
their customary way. 

like user-defined data structures in high-level languages, the STRUCT directive 
allows you to specify the beginning of a data structure. The data-definition directives 
that follow, until the next ends directive is encountered, define the members of * 
the structure. Members of the structure can be any data-definition directive you 
want; they do not have to be similar in type. The data structure will be known 
collectively by the symbolic name label. 
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If you are using MASM 6.0. you can specify an alignment value, align, which 
is used to align members of the structure in memory. Valid values are 1, 2, or 4. If 
you specify align, the amount of space taken by the structure may increase, but so 
will the speed with which members of the structure can be accessed. (The preceding 
sentence applies only to 16- or 32-bit processors.) 

Also, the non'jnique parameter specifies how stringent the assembler is in 
allowing subsequent references to members of the structure. If you use this 
parameter, you must provide a full structure and member name each time you want 
to reference a member. 


Example: 


PayRecord 

STRUCT 




LastName 

DB 

IS 

DUP 

( 0 ) 

FirstName 

0B 

15 

DUP 

(0) 

Address 

DB 

30 

DUP 

(0) 

City 

DB 

25 OUP 

(0) 

State 

DB 

'» 

',0 


ZipCode* 

DB 

10 

DUP 

(0) 

BasePay 

REAL4 

0 



Commission 

REAL4 

0 



HireMonth 

DB 

1 

m l 


HireOay 

DB 

• 

l 


HireYear 

DB 

1 

1 

,0 


ENDS 






SUBSTR: Return a Substring 

TASM^o* C aSSCm k* CrS: Micros °ft Quick Assembler 2.51, MASM 6.0. TASM 2.0, 
Directive category: String control 

Syntax: < 

label SUBSTR string, startl , end] 

Description: This directive functions much like its counterpan in some high-level 
languages. When assembled, it defines a text macro, with the name label, to be eoual 
to a substring of string. You specify the start character position in string and 
optionally specify an end character position. If you do not specify end, label will b 
equal to the pan of string from start to the end of string. 
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For instance, the following statements: 

verOate TEXTEQU 1 10/13/1991' 

Divider SuBSTR Verdate, 3, i 

Year SUBSTR Verdate, 7 

result in Divider being equal to/, and Year being equal to 1991. 

SUBTITLE: Specify Listing-File Subtitle 

Applicable assemblers: MASM 6.0 
Directive category: Listing control 
Syntax: 

SUBTITLE (text) 

Description: This directive, which is the same as the SUBTTL directive, is used to 
specify a subtidc that appears at the top of each page in the listing file. If a subtitle 
was set previously, the new subtitle will appear at the top of the following listing 
page. If you use SUBTITLE without a subtitle, no subtitle will be printed from that 
point forward. 

Normally, you use SUBTITLE with other page-control directives to get the 
effect you want. No subtitle is printed on the first page of a listing file, because the 
headers for the first page are printed before any of the lines of the source code are 
analyzed. 

SUBTTL: Specify Listing-File Subtitle 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1, MASM 6.0, 
TASM 2.0, TASM 3 0 

Directive category: Listing control 

Syntax: 

SUBTTL ltext] 

Description: This directive is used to specify a subtitle that appears at the top of 
each page in the listing file. If a subtide was set previously, the new subtitle will 
appear at the top of the following listing page. If you use SUBTTL without a subtitle, 
no subtitle will be printed from that point forward. 
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Normally, you should use SUBTTL with other page-control directives to get the 
effect you want. No subtitle is printed on the first page of a listing file, because the 
headers for the first page are printed before any of the lines of the source code are 
analyzed. 

If you are using TASM, you can use the \SUBTTL directive also to set a subtitle. 
Under MASM 6.0, you can use the SUBTITLE directive. 


%SUBTTL: Specify 7 Listing-File Subtitle 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 


Syntax: 

*sSUBTTL 'text' 


Description: This directive, identical in function and similar in form to the SUBTTL 
directive, is used to specify a subtitle that appears at the top of each page in the listing 

file If a subtitle was set previously, the new subtitle will appear at the top of the 
foijowing listing page. 

Normally, you use %SUBTT L with other page-control directives to get the effect 
you want No subtitle is printed on the first page of a listing file, because the headers 
for the first page are printed before any of the lines of the source code are analyzed 



SWORD: Allocate a Signed Word of Storage Space 

Applicable assemblers: MASM 6.0 
Directive category: Data allocation 
Syntax: 

(label) SWORD expression [, expression )• 


Description: This directive is similar to the DW and WORD directives. It is used m 
allocate 2 bytes of memon (a word) for data storage in the executable file. The i ah- i 
is a user-defined name you can use later to refer symbolically to the un a 
information. Each expression must be one of the following: re 


J A number berween -32.767 and 32.767 

■J A formula resolving to a number between -^2 T ' a' | - > - 7 ^- 
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□ A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the SWORD directive is longer than a single word, the label 
refers only to the first word of the allocated dau. 

Examples: 

Valuel SWORD -5432 

Value2 SWORD 2653 

Counter SWORD 0 

ScreenSize SWORD 80 • 25 

Array SWORD 12 DUP(?) 

%SYMS: Enable Symbol Table in Listing File 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

HSYUS 

Description: This directive, which is used to reverse the effects of the VtOSYMS 
directive, is the normal default condition for a listing file generated by TASM. 



TABLE: Define a Method Table 

Applicable assemblers: TASM 3 0 
Directive category: Complex dau types 
Syntax: 

label TABLE [member), member ] ...) 
or, if using ideal mode: 

TABLE label (me/nberj, member) ...1 

where each member has the following construction: 

l virtual) memberlabel I [arraysize]) I imamtypa) : count)) l •expression) 
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^>"scription: Tables are used with object-oriented programming. They represent 
metnod tables in such languages as Turbo Pascal and Borland C+ + . If you are 

writing extensive subroutines for use with these languages, vou necessarily wiU o e r 
into the use of tables. 61 

is theT! 1 / la l Cl is symboUc name used for referring to the table; the memberlabel 
Lin H.r e y ! CaCh mCmbcr of lhe tab,e 15 The memtype can be any 

members mc udmg pomters ^ you want to initialize any instances of the tabll 
members, you can use the expression to do so. 

If you2^ worLnr,n ^M de ^ H m0d K’ t2ble member names are ,ocal to the table. 

7 arc working in MASM mode, the names are global. 

this directive which Simnlv'rr^^ y ° U Can USC the muItdine y ersion of 

as the y ° U , PlaCe a ,Cft brace (0 ** same line 

pan of the definition. 8 Countered U P ^ a right brace (}) is considered 


%TABSIZE: Set Listing-File Tab-Stop Width 

Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Listing control 
Syntax: 

%TA8SIZE width 

■^3=£.-K5 s-sssr-ir - • 

between tab stops with this directive num ber of charaaers) 


TBLPTR: Force Table-Pointer Inclusion 

Applicable assemblers: TASM 3.0 

£ -rective category: Complex data types 
Syntax: 

TBLPTR 

-. • - r- —«* *■ 

C me TBLPrft d.tici vt enables you to do this. 


Scanned with CamScanner 


Chapter 23: Assembler Directives 


1013 


Typically V'ASM automatically provides this information in an object's data struc¬ 
ture as necessary’ This directive is designed to override the arbitrary nature of the 
able pointer's inclusion, however. When you include TBLPTR in the object data- 
structure definition, the pointer is included all the time. 


TBYTE: Allocate 10 Bytes of Storage Space 

Applicable assemblers: MASM 6 0 
Directive category: Data allocation 
Syntax: 

[label] TBYTE expression [, expression) 

Description: This directive is equivalent to the DT directive. It is used to allocate 10 
bytes of memory for data storage in the executable file. Typically, this data size is used 
for 10-byte integers or real number formats used with numeric coprocessors. The 
label is a user-defined name you can use later to refer symbolically to the stored 
information. Each expression must be one of the following: 

-9 BO 

□ A number between -2 and 2 -1 

Q A formula resolving to a number between -2 and 2 -1 

□ A packed decimal number between 0 and 10 2o -l 

□ An 80-bit temporary floating-point number between ±3.37 x lO - * 912 and 
±1.13 x lO-*’” 

G A question mark (used to hold space but not initialize the data area) 

• In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the tbyte directive is longer than 10 bytes, the labtl 
refers only to the first 10 bytes of the allocated data 

You can use the REALiO directive also for floating-point numbers. 

Examples: 


Values 

UemArea 

Array 


TBYTE 12345.6789, 987.6543 

TBYTE 1024 * 64 • 4 

TBYTE 12 DUP(?) 


14 
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%TEXT: Set Listing-File Source-Field Width 

Applicable assemblers: TASM 2.0, TASM 3 0 
Directive category: Listing control 
Syntax: 

%TEXT width 

Description: When you request a listing file (LST file) during assembly, this 
directive controls the width of the source-code held. You can set width to any 
reasonable number. 


TEXTEQU: Define a Text Macro 

Applicable assemblers: MASM 6.0 
Directive category: Macros and repeat blocks 
Syntax: 

label TEXTEQU value 

Description: This directive is used to assign strings to labels, which are known as 
text macros. The label is the name by which you want the string to be known; it is 
the name of the text macro. The value must resolve to a string or be the name of 
another text macro. Then, when the label is used later in your program the 
assembler substitutes the text assigned to the name. The string must be enclosed in 
angle brackets (< >). 

Examples: 

TEXTEQU <[bp+4]> ;Va ri is the text '(bpM]' 

TEXTEQU Varl ;Now Argl ** Van 

* 4 

TEXTEQU <Example > ♦ %Number ;Ex4 is the text ’Example 4* 


ft — 

TFCOND: Switch State of Conditional-Statement Listings 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5 l Macm a n 
TASM 2 0, TASM 3.0 ’ M b 0 


Van 

Argl 

Number 

Ex4 
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Directi • ategory: Listing control 
Syntax: 

.TFCOND 

Description: This directive switches (to the opposite method) theway the 
bier handles listing conditional assembly blocks. If they are being l^ted^execuung 
.TFCOND causes them not to be listed from that point on (and vice versa), 
the . LFCONO and .sfcono directives to specify exactly how conditionals s ou 

handled in listings. 


TITLE: Specify Listing-File Title 

Applicable assemblers: Microsoft Quick Assembler 2.51. MASM 5.1. MASM 6.0. 

TASM 2.0, TASM 3.0 

Directive category: Listing control 

Syntax: 

TITLE text 

Description: This directive, which can be used only once in your file, is used to 
specify a title that appears at the top of each page in the listing 

Normally you use title with other page-control directives io *cii1k 
you want No fide is printed on the first page of a listing file, because 1 
the first page are printed before any of the lines of the source code are analyzed. 

If you are using TASM. you can use the atitlE directive also to set a tide. 


%TITLE: Specify Listing-File Title 

Applicable assemblers: TASM 2.0. TASM 3-0 
Directive category: Listing control 
Syntax: 

VfTTLE * text • 

Description: This directive, which is identical in function and -° 

the title directive, is used to specify a title that appears at the top of each p g 
the listing file. This directive can be used only once in your file. 
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%TRUNC: Control Word-Wrapping in the Listing File 

Applicable assemblers: TASM 2 0, TASM 3.0 
Directive category: Listing control 
Syntax: 

STRUNG 

N Tl ly ' “, the SOUrC ' <ode Unes or generated code in the listing 
f' , h ; lon 8. to ** l,5,cd P r °P erl >- truncated. Thisuuncation occurs only 

wo™u* d" R T OBJ U tnjnca,io " has been disabled with the 

%nc , runc directive, the %trunc directive enables again. 


TYPEDEF: Define a Pointer Type 

Applicable assemblers: MASM 6.0, TASM 3.0 
Directive category: Complex data types 
Syntax: 

label TYPEDEF (distjr.e) ptr type 
Description: This directive allows vou to „ n 

-n your programs. The label us the nlme vou will use to reefer ** 

optional distance, used to ovemde the default dist^c« defined 1 J yPC ^ 
■ irective. can be either NEAR or FAR Finally Ten. r ^ ned w ’ ll> the .MOOEt. 

:ch as BYTE. word. etc. * represen “ “T regular data type 


UDATASEG: Define Beginning of Uninitialized 

Data Segment 

Applicable assemblers: TASM 2 0, TASM 3.0 

Directive category: Simplified segment control 
iyntax: 

UDATASEG 

JeSC |T P 'i°? dlr< ’ ctlv e is the same as the .oata? directive It is one r 
simplified data segment directives available. The others include ° fSevenl 
.DATA. DATA?, 0ATASEG. .FAR0ATA. FAR0ATA. . FAROATA7, and U^A. ' C0NST ' 
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This simplified segment directive is used to inform the assembler that the 
information immediately following should be placed in a special uninitialized data 
segment. You must use the MODEL or model directives before using UDATASEG. 

It is not necessary to use this special type of segment, but you may want to use 
it to group your data. Such grouping may help you understand the different parts of 
your program better. 


UFARDATA: Define Beginning of Uninitialized 
Far Data Segment 

Applicable assemblers: TASM 2.0. TASM 3 0 
Directive category: Simplified segment control 
Syntax: 

UFAROATA [ label] 

Description: This directive is the same as the .faroata? directive, ufardata is one 
of several simplified data-segment directives available The others include .CONST, 
CONST, .DATA. .DATA7, OATASEG, .FARDATA, .FAROATA?, FAROATA, and UDATASEG. 

This simplified segment directive is used to inform the assembler that the 
information immediately following should be placed in a special uninitialized far 
data segment. You must use the .MODEL or MODEL directives before using ufardata. 

It is not necessary to use this special type of segment, but you may want to use 
it to group your data. Such grouping may help you understand the different parts of 
your program better. If you use the optional label, the name should guide the way 
the linker combines different far data segments while linking. 



UNION: Define a Data Union 

Applicable assemblers: MASM 6.0, TASM 2.0, TASM 3 0 

Directive category: Complex data types 

Syntax: 

label UNI0N[, N0NUNI0UE) 

or, if you are using TASM in ideal mode: 

UNION label 
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Description: A union is a user-defined data structure in which members of the 

structure overlap one another. Thus, you can use unions to specify different ways to 
access the same data. 

The union directive allows you to specify the beginning of a data union. The 
data-definmon directives that follow, until the next ENDS directive is encountered 
define the members of the union. Members of the union can be any data-defmition 
directive you want; they do not have to be similar in type. The data union will be 
known collectively by the symbolic name label. 

« i„ 6 k *' NtWU ’T E parlme,er s P« i,ies how stringent the assembler 

ni _ m8 subse< I uent references to members of the union. If you use this 

reference's ”er Pr ° V ' de ’ Al " U " i0n and membcr «■* «■> time you wan, ,o 


• UNTIL; End a .REPEAT Loop 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

•UNTIL condition 


Operator 

Meaning 

= = 

Equal 

! = 

Not equal 

> 

Greater than 

> = 

Greater than or equal to 

< 

Less than 

< = 

Less than or equal to 

& 

Bit test 

&& 

Logical AND 

ii 

Logical OR 

t 

Logical NO T 
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You can also test automatically the condition of flags by using the following 
specialized flag-name operators: 


Operator 

Sample Use 

CARRY? 

.UNTIL (CARRY?) 

OVERROW? 

.UNTIL (OVERFLOW?) 

PARITY? 

.UNTIL (PARITY?) 

SIGN? 

.UNTIL (SI0N7) 

ZERO? 

.UNTIL (ZERO?) 

Example: 

.REPEAT 

;Walt for ESC Key to be pressed 

MOV AH,7 

;0irect character Input without echo 

INT 21 n 

;D0S services 

.UNTIL (AL -■ 27) 

;Keep going until ESC is pressed 


.UNTILCXZ: End a .REPEAT Loop 

Applicable assemblers: MASM 6.0 
Directive category: Control flow 
Syntax: 

.UNTILCXZ [condition] 

Description: This directive is used to mark the end of a loop constructed with the 
.REPEAT directive. These loops function the same as their counterparts in high-level 
languages. If used without a condition, the loop repeats until the value in CX is 0. 
If a condition b included, the loop continues until the condition b true or CX b 0. 

The condition used by the loop must resolve to either true or false. It can be 
complex (testing for two or more conditions) and may contain any of the following 
operators: 

Operator Meaning 

Equal 
Not equal 
Greater than 
Greater than or equal to 
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Operator 

Meaning 

< 

Ix'ss than 

< = 

Less than or equal to 

& 

bit test 

&& 

1! 

Logical AND 

Logical OR 

1 

Logical NOT 

You can also tes. automatically the condition of flags by using the following 
specialized flag-name operators 

Operator 

Sample Use 

CARRY’ 

-UNTILCXZ (CARRY?) 

OVERFLOW 

•UNTILCXZ (OVERFLOW?, 

PARITY-' 

•UNTILCXZ (PARITY?) 

SIGN’ 

-UNTILCXZ (SIGN?) 

ZERO’ 

• 'JN’ILCXZ (ZERO?, 

Example: 

• 

MOV CX, A 

.REPEAT 

MOV Ah,7 

INT 2lh 

;Want a cnaracters 
;Locp until < are input 
-.Direct character input without echo 
;D0S services 


.UNTILCXZ 



USES: Specify Registers To Save 


Applicable assemblers: TASM 2.0, TASM 3.0 
Directive category: Procedures and code Labels 


Syntax: 


USES register), register) ... 

Description: This directive allows you to specify the registers you want saved when 

a procedure is invoked and restored when the procedure is finished. The roosters 
should be separated by commas. regwtexs 
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Note that if you are using MASM, you can specify a register-saving list on the 
PROC line. Refer to the PROC directive for more information. 


VERSION: Specify Version Compatibility 

Applicable assemblers: TASM 3 0 
Directive category: Global control 
Syntax: 

VERSION versior.IO 


Description: Most programmers know that assembler makers change things from 
one version to another. Sometimes those changes can wreak havoc with your code. 

With this directive, you can specify the assembler and version for which you 
have written your code. The versionlD must be one of the following: 

ID Compiler 

M400 

MASM 4.0 

M500 

MASM 5 0 

M510 

MASM 5.1 

M520 

Quick Assembler 

T100 

TASM 1.0 

T101 

TASM 1.01 

T200 

TASM 2.0 

T250 

TASM 2.5 

T300 

« 

TASM 3 0 


Using this directive limits the directive and power available with the assembler. 
It also sets the proper settings for the masm, MASM51, QUIRKS, and SMART directives. 


WARN: Enable Warnings 

Applicable assemblers: Microsoft Quick Assembler 2.51, TASM 2.0, TASM 3 0 
Directive category: Global control 
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Syntax: 

WARN (ClSSS) 

Description: TASM allows ycu to disable warnings with the nowaan directive. This 
directive allows you to enable display of certain warning classes (or all warnings) that 
may have been suppressed previously. 


If you provide a warning class, this directive enables display of warning 
messages in that class. If you provide no parameters, all warning messages are 
enabled. 

The warning classes are as follows: 

Class Meaning 

ALN 

Segment alignment 

ASS 

Assume segment is 16-bit 

BRK 

Brackets needed 

ICG 

Inefficient code 

LCO 

Location counter overflow 

OPI 

Unterminated (open) IF condition 

OPP 

Unclosed (open) procedure 

OPS 

Unclosed (open) segment 

OVF 

Arithmetic overflow 

PDC 

Pass-dependent coding 

PRO 

Incorrect protected-mode memory write 

PQK 

Assuming constant warning 

RES 

Reserved word infraction 

TPI 

Illegal Turbo Pascal operation 



.WHILE: Declare the Beginning of a Controlled Loop 

Applicable assemblers: tyASM 6.0 
Directive category: Control flow 
Syntax: 

.WHILE condition 
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Description: This directive is used to construct a loop similar to the WHILE loops 
in high-level languages. The loop, which may contain any number of statments, 
is terminated with the . ENOW directive. 


The condition used by the loop must resolve to either true or false. It can be 
complex (testing for two or more conditions) and may contain any of the following 
operators: 

Operator Meaning 

= = 

Equal 

i = 

Not equal 

> 

Greater than 

> = 

Greater than or equal to 

< 

Less than 

< = 

Less than or equal to 

& 

Bit test 

&& 

Logical AND 

II 

Logical OR 

i 

Logical NOT 

You can also test automatically the condition of flags by using the following 

specialized flag-name operators: 

Operator 

Sample Use 

CARRY? 

.WHILE (CARRY?) 

OVERFLOW? 

.WHILE (OVERFLOW?) 

PARITY? 

.WHILE (PARITY?) 

SIGN? 

.WHILE (SIGN?) 

ZERO? 

.WHILE (ZERO?) 


Loops that use .while can be nested with other .while or . REPEAT loops. These 
loops can be terminated normally with the . ENOW directive, or prematurely with the 
.BREAK or .CONTINUE directives. 

Do not confuse the .WHILE directive with the while directive. They have 
different purposes and actions. 
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Example: 


MOV AL,0 


Start with a clean slate - 
Keep going until Enter is pressed 
Direct character input without echo 
DOS services 


.WHILE (AL I* 13) 


MOV AH,7 

INT 21h 

.ENOW 


The preceding example is the same as the following, nondirective method of 
coding this loop: 


MOV AL,0 

InLoop: CMP AL,13 


;Start with a clean slate 
;Was Enter pressed? 

;Yes, so exit 

jDirect character input without echo 

;00S services 

;Back to the beginning 


JE OutLoop 

MOV AH,7 

INT - 21h 

JMP InLoop 


OutLoop: 



WHILE: Repeat a Block of Instructions 

Applicable assemblers: MASM 6.0, TASM 3.0 
Directive category: Macros and repeat blocks 
Syntax: 

WHILE expression 

Description: This directive provides a way for the assembler to repeat a code block 
until a cenain expression proves false. Typically, this directive is used in macros. 
Every source-code line between the while directive and the enom or exitm directives 
is repeated until while proves to false (0). 

Example: 

Alphabet EQU THIS BYTE 


letter ■ *A' 

WHILE letter LE *2' 
OB letter 
letter ■ letter +i 
ENOM 
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WORD: Allocate a Word of Storage Space 

Applicable assemblers: MASM 6 0 
Directive category: Data allocation 
Syntax: 

lla&elj WORD expression, expression] 

Description: This directive is equivalent to the DW directive. It is used to allocate 2 
bytes of memory (a word) for data storage in the executable file. The label is a user- 
defined name you can use later to refer symbolically to the stored information. Each 
expression must be one of the following: 

□ A number between -32,767 and 65,535 

□ A formula resolving to a number between -32,767 and 65,535 

□ An offset for an address pointer r 

□ A segment for an address pointer 

□ A question mark (used to hold space but not initialize the data area) 

In addition, you can use the DUP operator to specify multiple occurrences of 
the data in the expression. 

If the data allocated by the word directive is longer than a single word, the label 
refers only to the first word of the allocated data. 

If you are working exclusively with signed data, you can use the SWORD directive 


also. 




Examples: 

Addressi 

WORD 

Routine 

;Addressl contains only the offset 

Address2 

WORD 

OFFSET Routine * 

;Addressl contains only the offset 

Address3 

WORD 

SEGMENT Routine 

;Addressl contains only the segment 

Counter 

WORD 

e 


ScreenSize 

WORD 

80 * 25 


Array 

WORD 

12 DUP{?) 



.XALL: List Only Macros that Generate Code 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5.1. MASM 6.0, 
TASM 2.0, TASM 3-0 

% 


Scanned with CamScanner 





1026 Pan IV: Reference 


Directive category: Listing control 
Syntax: 

. XALL 

Description: If you use macros a great deal, you probably will use this directive also. 
It results in the expansion (listing) only of macros that generate code. If you use 
TASM, this is the same as the snomacs directive. 


.XCREF: Disable Cross-Referencing 

Applicable assemblers: MASM 5.1, MASM 6.0, TASM 2.0, TASM 3.0 

Directive category: Listing control 

Syntax: 

.XCREF 

Descr ption: If this directive is executed, cross-referencing is turned off completely 
in the .jsting file. If you are using TASM, it is turned off in the XRF file also. 



.XLIST: Disable Source-Code Listing 

Applicable assemblers: Microsoft Quick Assembler 2.51, MASM 5 1 MASM 6 0 
TASM 2.0, TASM 3 0 * ’ *’ 

Directive category: Listing control 

Syntax: 

.aLIST 

Description: Use this directive to instruct the assembler to suspend sending listing 
nformation to the listing file. Even with this directive in place, however the 
assembler will include symbol and cross-reference information in the file 

If you are using TASM, you can use the VJ01IST directive interchangeably with 
this one. Also, you can use . nolist under MASM 6.0. y 
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o 

SI 

"O •* 

29h 

41 

) 


lOh 

16 

► 
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4 
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43 

♦ 


12h 

18 

f 

DC 2 

*R 

2Ch 

44 



llh 

19 

u 

DC3 

*S 

2Dh 

45 

i 


14h 

20 

1 

DC4 


2Eh 

46 

% 


15h 

21 

S 

NAK 


2Fh 

47 

/ 


16h 

22 

■ 

SYR 


30h 

48 

0 


17h 

21 

l 

ETB 


llh 

49 

1 


18h 

24 

t 

CAM 

*x 

12h 

50 

2 


19h 

25 

i 

EM 

“Y 

llh 

51 

3 



1027 
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Hex 

Dec 

Screen 

Hex 

Dec 

Screen 

Hyc 

Dec 

Screen 

i I y.l 

34h 

52 

4 

62h 

90 

b 

9 Oh 

144 

t 

35h 

53 

5 

63h 

99 

c 

9 lh 

145 

a 

3Sh 

54 

6 

64h 

100 

d 

92h 

146 

£ 

37h 

55 

7 

65h 

101 

e 

93h 

147 

6 

38h 

56 

8 

66h 

102 

f 

94h 

148 

tt 

39h 

57 

9 

67h 

103 

9 

95h 

149 

6 

3 Ah 

58 

• 

• 

68h 

104 

h 

96h 

150 

Q 

3Bh 

59 

• 

9 

69h 

105 

i 

97h 

151 

0 

3Ch 

60 

< 

6 Ah 

106 

j 

98h 

152 

y 

3Dh 

61 

S 

6Bh 

107 

k 

99h 

153 

6 

3Eh 

62 

> 

6Ch 

108 

1 

9 Ah 

154 

0 

3Fh 

63 

7 

6Dh 

109 

m 

9Bh 

155 

4 

40h 

64 

§ 

6 Eh 

110 

n 

9Ch 

156 

E 

4 lh 

65 

A 

6Fh 

111 

o 

9Dh 

157 

V 

42h 

66 

B 

70h 

112 

p 

9Eh 

158 

R 

43h 

67 

C 

71h 

113 

q 

9Fh 

159 

/ 

44h 

68 

D 

72h 

114 

r 

AOh 

160 

4 

45h 

69 

E 

73h 

115 

a 

Alh 

161 

I 

46h 

70 

F 

74h 

116 

t 

A2h 

162 

6 

47h 

71 

G 

75h 

117 

u 

A3h 

163 

a 

48h 

72 

H 

76h 

118 

V 

A4h 

164 

ft 

49h 

73 

i 

77h 

119 

w 

A5h 

165 

N 

4 Ah 

74 

J 

7 8h 

' 120 

X 

A6h 

166 

• 

4Bh 

75 

K 

79h 

121 

y 

A7h 

167 

• o 

4Ch 

76 

L 

7 Ah 

122 

z 

A8h 

168 

• 

40h 

77 

H 

7Bh 

123 

{ 

A9h 

169 

W 

r* 

4Eh 

78 

N 

7ch 

124 

1 

AAh 

170 


4Fh 

5 Oh 
51h 
52h 
53h 
. 54h 
55h 
56h 
57h 
58h 
59h 

5 Ah 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 
£ 9 
90 

0 

P 

0 

R 

S 

T 

U 

V 

W 

X 

Y 

Z 

7Dh 

7Eh 

7Fh 

80h 

8 lh 
82h 
83h 
84h 
85h 
86h 
87h 
88h 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

> 

A 

9 

U 

4 

A 

a 

A 

& 

9 

A 

ABh 

ACh 

ADh 

AEh 

AFh 

BOh 

Blh 

B2h 

B3h 

B4h 

B5h 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 

h 

k 

i 

« 

» 

— 

•m 

3 

B 

1 

SBh 

91 

l 

89h 

137 

4 

B 6 h 

182 

^1 

5Ch 

92 

• \ 

8 Ah 

138 

A 

B7h 

183 


5Dh 

93 

) 

8Bh 

139 


B8h 

184 


5Eh 

94 

A 

8Ch 

140 

1 

B9h 

185 

1 

4 

5Fh. 

95 


8Dh 

141 

1 

BAh 

186 

II 

6'0h 

56 

1 

8Eh 

142 

X 

BBh 

187 

ii 

41 

6 lh 

97 

a 

8Fh 

143 

k 

BCh 

188 

11 

dl 







BDh 

ie9 

j) 
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Dec 

190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 

201 

202 

203 

204 

205 

206 

207 

208 

209 

2 It) 

211 


II 1^=3 
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Screen 

4 

7 

L 

-L 

T 

I- 

+ 

► 

w 

II 



Hex 

Dec 

Scret 

D4h 

212 

k 

D5h 

213 

r 

D6h 

214 

IT 

D7h 

215 

4 

D8h 

216 

* 

D9h 

217 

j 

DAh 

218 

✓ 

r 

DBh 

219 

B 

DCh 

220 

■ 

DDh 

221 

1 

DEh 

222 

1 

DFh 

223 

■ 

EOh 

224 

a 

Elh 

225 

P 

E2h 

226 

T 

E3h 

227 

TT 

E4h 

228 

z 

E5h 

229 

a 

E6h 

230 

V 

E7h 

231 

z 

E8h 

232 

♦ 

E9h 

233 

e 


Pf* 

Dec 

Screen 

EAh 

234 

n 

EBh 

235 

6 

ECh 

236 

CO 

EDh 

237 

4> 

EEh 

238 

e 

EFh 

239 

n 

FOh 

240 

s 

Flh 

241 

i 

F2h 

242 

£ 

F3h 

243 

5 

F4h 

244 

r 

F5h 

245 

j 

F6h 

246 

+ 

F7h 

247 

- 

F8h 

248 

o 

F9h 

249 

• 

FAh 

250 

• 

FBh 

251 

yf 

FCh 

252 

n 

FDh 

253 

2 

FEh 

254 

■ 

FFh 

255 
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APPENDIX 



Keyboard 
Interpretation Tables 


T 


his appendix contains two tables that will be useful when you interface to the 
keyboard, either through BIOS or directly through the hardware port. 


BIOS Keyboard Codes 

Table B 1 shows the scan code/ASCII value combinations returned through the 
BIOS keyboard services. The keyboard controller does not 
directly. Instead. BIOS translates (into the codes shown in this table) the codes 

gives to the key board controller. 


Table B. 1. BIOS keyboard codes. 

Scan Code 
Decimal Hex 


0 

1 

2 


00 
01 . 
02 

03 


Decimal 

0 
27 

49 
33 

50 
64 

0 


ASCII Value 

Hex Keystroke 


00 

IB 

31 
21 

32 
40 
00 


Break 

Esc 

1 

1 

2 

(S' 

Ctrl-<£ 


103 
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Table B. 1. continued 


Scan Code ASCII Value 

Decimal Hex Decimal Hex Keystroke 


4 

.04 

51 

33 

3 



35 

23 

# 

5 

05 

52 

34 

4 


- 

36 

24 

1 

6 

06 

53 

35 

5 



37 

25 

% 

7 

07 

54 

36 

6 . 



94 

5E 




30 

' IE 

Ctrl-~ 

8 

08 

55 

37 

7 



38 

26 

& . 

9 

09 

56 

38 

8 



42 

2A 

• (Shift-8) 

10 

0A 

57 

39 

9 



40 

28 

( 

11 

OB 

48 

30 

0 



41 

29 

) 

12 

OC 

45 

2D 




95 

5F 




31 

IF 

CtrI-_ 

13 

0D 

61 

3D 




43 

2B 

+ 

14 

0E 

8 

08 

Backspace 

15 

OF 

127 

7F 

Ctrl-Backspace 

9 

09 

Tab 



0 

00 

Back tab 

16 

10 

113 

71 

q 



81 

51 

Q 



0 

00 

AJt-Q 



17 

11 

Ctrl-Q y* 

17 

11 

119 

77 

w 



87 

57 

W 



0 

00 

Alt-W 



23 

17 

Ctrl-W 
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Scan Code 

Decimal Hex 

Decimal 

ASCII Value 
Hex 

Keystroke^ 

18 

12 

101 

65 

t 


69 

45 

E 



0 . 

00 

Alt-E 



5 

05 

Ctrl-E 

19 

13 

114 

72 

r 


82 

52 

R 



0 

00 

Alt-R 



18 

12 

Ctrl-R 

20 

14 

116 

84 

74 

54 

t 

T 



0 

00 

Alt-T 



20 

14 

Ctrl-T 

21 

15 

t r 

121 

89 

79 

59 

y 

Y 



0 

00 

Alt-Y 



25 

19 

Ctrl-Y 

22 

16 

117 

85 

75 

55 

u 

U 


* 

0 - 

00 

Alt-U 



21 

15 

Ctrl-U 

23 

17 

105 

73. 

69 

49 

i 

1 



0 

00 

AIM 



9 

09 

Ctrl-l 

24 

18 

111 

79 

6F 

4F 

o 

O 



0 

00 

Alt-O 



15 

OF 

Ctrl-O 

25 

19 

112 

80 

70 

50 

P 

? 



0 

00 

Alt-P 



16 

10 

Ctrl-P 

26 

1A 

91 

5B 

( 


123 

7B 

{ 



27 

IB 

Ctrl-l 

27 

IB 

93 

125 

5D 

7D 

1 

} 



29 

ID 

Ctrl-l 


continues 
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Scan Code 

Decimal Hex 


28 

30 


31 


32 


33 


34 


35 


36 


37 


38 


1G 

IE 


IF 


20 


21 


22 


23 


24 


25 


26 


ASCII Value 

Decimal Hex Keystroke 


13 

0D 

Enter 

97 

61 

a 

65 

41 

A 

0 

00 

Alt-A ■ 

1 

01 

Ctfl-A 

115 

73 

s 

83 

53 

S 

0 

00 

Alt*S 

19 

13 

Ctrl'S 

100 

64 

d 

68 

44 

D 

0 

00 

Alt'D 

4 

04 

Ctrl-D 

102 

66 

f 

70 

46 

F 

0 

00 

Alt*F 

6 

06 

Ctrl-F 

103 

67 

g 

71 . 

47 

G 

0 

00 

Ait-G 

7 

47 

Ctrl-G 

104 

68 

h 

72 

48 

H 

0 

00 

Alt'H 

8 

08 

Ctrl-H 

106 

6A 

i 

74 

4A ' 

J 

0 

00 

Alt*J 

10 

OA 

Ctrl-J 

107 

6B 

k 

75 

4B 

K 

0 

00 

AJt-K 

11 

OB 

Ctrl-K 

108 

6C 

1 

76 

4C 

L 

0 

00 

Alt'L 

12 

OC 

Ctrl-L 
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Scan Code 

Decimal Hex 

Decimal 

ASCII Value 
Hex 

r 

Keystroke 

39 

27 

59 

3B 

9 


« 

58 

3A 

: 

: 40 

28 

39 

27 

« 



34 

22 

li 

41 

29 

96 

60 

' (accent grave) 



126 

7E 

— 

43 

2B 

92 

5C 

\ 



124 

7C 

1 



28 

1C 

CtrlA 

44 

2C 

122 

7A 

z 



90 

5A 

Z 



0 

00 

' Alt-Z 



26 

1A 

Ctrl-Z 

45 

. r> 

2D 

120 

78 

X 


. 

88 

58 

X 



0 

00 

Alt-X 


• 

24 

18 

Ctrl-X 

46 

2E 

99 

63 

c 


67 

43 

C 



0 

00 

Alt-C 



3 

03 

Ctrl-C 

47 

2F 

118 

76 

V 


86 

56 

V 


* 

0 

00 

Alt-V 



22 

16 

Ctrl-V 

48 

30 

98 

62 

b 



66 

42 

B 


. 

0 

00 

Alt-B 



2 

02 

Ctrl-B 

49 

31 

110 

6E 

n 



78 

4E 

N 

ML. 


0 

00 

Alt-N 



14 

0E 

Ctrl-N 

50 

32 

109 

6D 

m 



77 

4D 

M 



0 

00 

Alt'M 



13 

0D 

Ctrl-M 


cantlnuti 
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Scan Code 
Decimal Hex 


Decimal 


ASCII Value 
Hex 



52 

53 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 


34 

35 

37 

38 

39 
3A 
3B 
3C 
3D 
3E 
3F 

40 

41 

42 

43 

44 

45 

46 

47 


44 

60 

46 
62 

47 
63 
42 

0 

0 

32 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 


2C 

3C 

2E 

3E 

2F 

3F 

2A 

00 

00 

20 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


48 

55 

37 

0 

00 

49 

56 

38 

0 

00 

4A 

57 

39 

45 

2D 

4B 

0 

00 

4C 

52 

34 

0 

00 


53 

35 


/ 

> 

• (next to keypad) 
Ait-Pause 

Ait-Break 

Space 

. Caps Lock 
FI 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
F10 

Num Lrx-fr 
Scroii Lock 
Home 
7 (keypad) 
Uparrow 
8 (keypad) 

PgUp 

9(keypad) 

~ (^Qt to keypad) 
Left arrow 
4 (keypad) 

Center key (keypad) 
5 (keypad) 
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Scan Code 
Decimal Hex 


ASCII Value 

Decimal Hex Keystroke 


77 

4D 

78 

4E 

79 

4F 

80 

50 

81 

51 * 

82 

52 

83 

53i , 

84 

54 . 

85 

55 

86 

56 

87 

57 

88 • 

58 

89 

59 

90 

5A 

91 

5B 

92 

5C 

93 

5D 

94 

5E 

95 

5F 

96 

60 

97 

61 

98 

62 

99 

63 

100 

64 

101 

65 

102 

66 

103 

67 


00 

Right arrow 

36 

6(keypad) 

2B 

+ (next to 
keypad) 

00 

End 

31 

1 (keypad) 

00 

Down arrow 

32 

2 (keypad) 

00 

PgDn 

33 

3 (keypad) 

00 

Ins 

30 

0 (keypad) 

00 

Del 

2E 

. (keypad) 

00 

Shlft-Fl 

00 

Shift-F2 

00 

Shifi-F3 

00 

Shift*F4 

00 

Shift-F5 

00 

Shift-F6 

00 

Shift-F7 

00 

Shift-F8 

00 

Shlft-F9 

00 

Shift-FlO 

00 

Ctrl-Fl 

00 

Ctrl-F2 

00 

CtrUF3 

00 

Ctrl-F4 

00 

Ctrl*F5 

00 

Ctrl-F6 

00 

Ctrl-F7 

00 

Ctrl-F8 

00 

Ctrl-F9 

00 

Ctrl-FlO 


continues 


0 

54 

43 

0 

49 

0 

50 

0 

51 

0 

48 

0 

46 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 
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..Scan Code 
Decimal Hex 


104 

68 

0 

00 

105 

69 

0 

00 

106 

6A 

0 

00 

107 

6B 

0 

00 

108 

6C 

0 

00 

109 

60 

0 

00 

110 

6E 

0 

00 

111 

6F 

0 

00 

112 

70 

0 

00 

113 

• 71 

0 

00 

114 

72 

0 

00 

113 

73 

0 

00 

116 

74 

0 

00 

117 

75 

0 

00 

118 

76 

0 

00 

119 

77 

0 

00 

120 

78 

0 

00 

121 

79 

0 

00 

122 

7A 

0 

00 

123 

7B 

0 

00 

124 

7C 

0 

00 

125 

7D 

0 

00 

126 

7E 

0 

00 

127 

7F 

0 

00 

128 

80 

0 

00 

129 

81 

0 

00 

130 

82 

0 

00 

131 

83 

0 

00 

132 

84 

0 

00 


ASCII Value 

Decimal^ Hex Keystroke^ 

Ait-Fl 
AU-F2 • 
Alt-F3 
Alt-F4 
Alt-F5 
Alt-F6 
Alt-F7 
Alt*F8 
Alt-F9 
Alt-FlO 
Ctrl-PrtSc 
Ctrl-Left arrow 
Ctrl-Right arrow 
Ctrl-End 
Ctrl-PgDn 
Ctrl-Home 
AIM (keyboard) 
Alt-2 (keyboard) 
Alt-3 (keyboard) 
Alt-4 (keyboard) 
Alt-5 (keyboard) 
AJt-6 (keyboard) 
Alt-7 (keyboard) 
Alt-8 (keyboard) 
Alt-9 (keyboard) 
Alt-0 (keyboard) 
Alt— (keyboard) 
Alt-** (keyboard) 
Ctrl-PgUp 
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Keyboard Controller Codes 

Table B.2 shows the key codes returned when you access the keyboard 
controller through hardware port 60h. Notice that this table is a good deal shorter 
than table B.l. The keyboard controller does no translation on the Shift, Ctrl, and 
Alt keys. Each key is given a specific position value, which BIOS translates Into the 
appropriate scan code/ASCIl value combination. 


Table B.2. Keyboard controller codes. 
Key Code 

Decimal Hex Key 


1 

01 

Esc 

2 

02 

1 

3 

03 

2 

4 

04 

3 

5 

05 

4 

6 

06 

5 

7 

07 

6 

8 

' 08 

7 

9 

09 

8 

10 

0A 

9 

11 

0B 

0 

12 

OC 

• 

13 

0D 

as 

14 

0E 

Backspace 

15 

OF 

Tab 

16 

10 

q 

17 

11 

w 

18 

12 

e 

19 

13 

r 

20 

14 

t 

21 

15 

y 

22 

16 

u 

23 

17 

1 

24 

18 

o 


continues 
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Table B.2. continued 


Decimal 

25 

26 

27 

28 

29 
29/69 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

>2 
42/52 
42/71 
42/72 
42/73 
42/75 
42/77 
42/79 
42/80 
42/81 
42/82 
42/83 

43 


fay Cofa 

Hex 

19 
1A 
IB 
1C 
ID 

ID/45 
IE 
IF 

20 
21 
22 

23 

24 

25 

26 

27 

28 
29 
2A 

2A/34 
2A/47 
2A/48 
2A/49 
2A/4B 
2A/4D 
2A/4F 
2A/50 
2A/51 
2A/52 
2A/53 
2B 


fay 
P 

I 

J • 

Enter 

Ctrl 

Pause 

a 

s 

d 

f 

g 

h 

i 


' (accent grave) 

Left Shift 

t 

PrtSc (enhanced keyboard) 

Horae (middle, enhanced keyboard) 

Up arrow (middle, enhanced keyboard) 
PgUp (middle, enhanced keyboard) 

Left arrow (middle, enhanced keyboard) 
Right arrow (middle, enhanced keyboards 
End (middle, enhanced keyboard) ' 
Down arrow (middle, enhanced keyboard* 
PgDn (middle, enhanced keyboard) * 
Insen (middle, enhanced keyboard) 

Del (middle, enhanced keyboard) 
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Decimal 

Key Code 
Hex 

Key 

44 

2C 

2- 

45 

2D 

X 

46 

2E 


47 

2F 

V 

48 ' 

30 

b 

49 

31 

n 

50 

32 

m 

51 

33 


52 

34 

• 

53 

35 

/ 

54 

36 

Right Shift 

55 

37 

• (next to keypad) : 

56 

36 

Alt 

57' 

39 

Space 

58 

3A 

Caps Lock . 

59 


FI 

60 

3C 

F2 

61 

3D 

F3 

.62 

3E 

F4 

* 63 

3F 

F5 

64 

48 

. F6 

65 

41 

F7 

66 

42 

F8 

67 

43 

F9 

68 

44 

F10 

69 

45 

Num Lock 

70 

46 

Scroll Lock 

71' 

47 

Home (keypad) 

72 

48 

Up arrow (keypad) 

73 

49 

PgUp (keypad) 

74 

4A 

- (next to keypad) 

75 ' 

4B 

Left arrow (keypad) 

76 

4C 

5 (keypad) 
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Table B. 2. continued 



Decimal 

Key Code 
Hex 

Key 


77 

4D 

Right arrow (keypad) 

- 

78 

4E 

f (next to keypad) 


79 

4F 

End (keypad) 


80 

50 

Down arrow (keypad) 


81 

51 

PgDn (keypad) 


82 

52 

Ins (keypad) 


83 

53 

Del (keypad) 


84 

54 

[Currently unused] 


85 

55 

[Currently unused] 


86 

56 

[Currently unused] 


87 

57 

Fll 


88 

58 

F12 



Some keys, especially on the enhanced 101-key keyboard «>n,m ^ u, 
values. These values, shown with a slash between the rwn u tUm double 
according to the first number of the pair. umbers, are listed 


Each key is designated by the unshifted value shown on the keycap. 


Scanned with CamScanner 











Glossary 


Align type. An assembly language directive specifying how the start of the seg¬ 
ment is to be aligned in memory. The align type is specified on the same line as the 
segment name. See also BYTE, PAGE, PARA, and WORD. 

ALU. Arithmetic/Logic Unit, the portion of the CPU that performs arithmetic 
functions on data. The ALU controls the settings of the bits in the flags register. 

ASCII. American Standard Code for Information Interchange. 

ASCIIZ. An ASCII string that is terminated with a null character (value of 0). ASC11Z 
is used extensively in DOS interrupt services. 

Assembler. The software program that translates (assembles) assembly language 
mnemonics into machine language for direct execution by the computer. 

Assembly language. The pseudo-English language, called source code, that is 
written and hopefully readable by humans. Assembly language is not directly 
executable by a computer. 

Assembly. The process of code conversion performed by an assembler. Assembly 
language source code is translated into machine language through this process. 

AT. A segment combine type used generally to prepare a template to be used for 
accessing fixed-location data. In the format AT XXXX (where XXXX is a memory 
address), ATsignifies that addresses and offsets are to be calculated relative to the 
specified memory address. See also Combine type , COMMON, MEMORY, PRIVATE, 
PUBLIC, and STACK. 

Auxiliar y carry flag. The bit in the flag register that indicates whether the previous 
decimal operation resulted in a carry out of or borrow into the four low-order bits 
of the byte. 
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AX. A general-purpose data register 

Base register. A register containing an address that is used as a base in indirect 
addressing methods. The base register is usually the BP or BX register 

BCD. Binary Coded Decimal. 

Binary. a numbering system based on only two digits. The only valid digits in a 
binary system are 0 and 1. See also Bit. * 

BIOS. An acronym for Basic Input/Output System—a collection of low-level system 
functions that enable programs to take advantage of system resources. 

T' 0f s ' ora * e on a computer. Each bit can have a 
valueof 0 or 1, indicating the absence or presence of an electrical signal. See also 

BP. The base pointer register. 

BX. A general-purpose data register. 

Byte. A basic unit of data storage and manipulation. A byte is equivalent to 8 bic 
and can contain a value ranging from 0 through 255. ^ ^ 8 b 

BYTE. A segment align type that directs the assembler to nlarr rf,^ 

next available byte after completing the preceding scmfnf l* at thc 

PAGE, PARA, and WORD. 8 gmcni Scc Align type, 

su^outine >SSemb,y *“*“■*' ‘ IaaUCa ° n “ Uin « tbe “^ler td perform the 

Carry flag. The bit in the flag register that indicates whether rh^ 
rcsubrt carry out of or borrow l„,„ dm harder bit ofTrcm 

CGA. Color Graphics Adapter. 

Class type An assembler directive Indicating how individual s,^ 
grouped when linked. Segments having the same class type are "* to ■* 

in memory before another class type is begun. The class rymiTs^Hfi J” nUgUously 
line as tbe segment name and is enclosed by single quoaUonmSL" ‘ he “ n “ 

£ rr t r bl " <UreCtiT ' ‘ h “ defin " "«•««»«» wtth the 
AU COMMON segments wtth die JTnaisct^ 

resulting segment equal in length to the longest individual ***“• Mth thc 

and offcecs in the resulting segment are relative to a sin»i 8,0601 ^ dresses 
also AT, Combine type, MEMORY, PRIVATE, PUBLIC, and STa^T*" 1 rC * Ster 566 
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Compiler. A program that translates high-level language source cedar into either 
machine code or pseudocode. Machine code can he directly executed by a com¬ 
puter, but pseudocode requires a run-time routine to work properly. 

Control Word. A 16-bit register used in the NPX/FPU to govern the way the chip 
works. 


CPU. The microprocessor (central processing unit) responsible for operations 
inside the computer. These operations generally include system timing, logical 
processing, and logical operations. 

CS. The code segment register. 

OL A general-purpose data register, normally used for counting functions. 

DASD. Direct access storage device. The term was coined by IBM and is used 
extensively in their documentation. 

Device driver. A program that controls the way DOS communicates with an exter¬ 
nal device. Typically, device drivers are loaded when DOS is started (booted). 

DI. The destination index register. 


Direction flag. The bit in the flag register that indicates whether string operations 
should increment (DF clear) or decrement (DF set) the index registers. 

Displacement. An offset from a specified base point. 

DMA. Direct memory access; a method of data transfer Involving direct access of 
the HAM buffer area through specialized circuitry. DMA fcees the CPU for other 
operations and results in a more efficient use of computer resources. 

DOS. An acronym for Disk Operating System, the program that controls the way 
your computer functions. 

DOS extender. A control program that allows DOS to access and use memory above 
the historical 640K boundary. 

DS. The data segment register. 

DTA. A memory area (disk transfer area) «Kdwith M Me ogatog to,** 
transfer of information to and ffom the Boppy disk. See also Chapter 21. scrv.ee 

21/1A. 

DX_ A general-purpose data register. 


EGA. Enhanced Graphics Adapter. 

ENDP. An assembler directive indicating the end of a procedure. See also PROC. 


EQU. An assembly language directive (equate). See also equate. 


Scanned with CamScanner 




Equate. The fall-word form of the assembly language directive EQU. Equate assigns 
ro a mnemoruc label a value that is later substituted for other occurrences of the 
label dunng program assembly. See also EQU. 

ES. The extra segment register. 

Exception. AnNPX/FPU term relating to a flag set in the status word register if an 
operation renders an exceptional result (outside normal bounds). 

CS^pfoT^e d «?rlf a pA? USheS lhC rctUrn address ( cffe «ively, the contents of 

,$ “ sumed ,obeu “ code je * men * dife " n ' 

FCB. File Control Block. 

Hag. An indicator used to control or signal txher software or hardware functions. 

Flat addressing. A memory configuration scheme in which all of memory is viewed 
as one contiguous stream of bytes. memory is viewed 

FPU. An acronym for Floating-Point Unit. This is die equivalent of an 80387 NVX 
built into the 80486 microprocessor. NPX 

tef the* ES register. 6 ^^ 1 * Se * m ' :m tCgiM ' r far the 80286 “<*Identical in use 

entire operation of the CPU. descriptors for the 

Group. A collection of segments that fit mo a biK seament of ram a. i a 
2S."- 5egmem ""“P “-fc— » determine how sc^« 

» U^Esf^Vcr SegnU:m K * Mr ' 0t ‘ hC 80286 and 80386 identical in use 

Hexadecimal. A numbering system based on 16 elements Dicits are n,. m h* a „ 
through F. as follows: 0. 1. 2. 3. s. 5,6, 7 .8. 9. A. B. C. D, E F b * red 0 

HGA. Hercules Graphics Adapter. 

80286 , 80^6 or 0)^86 ^o Icplace^tfaf im protcctcd * modc Programming of the 
memory on the 8086/8088. errupt vectors normally located in low 
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Index register. A register assumed to contain an address for use in indirect 
addressing modes. Usually, the index register consists of the SI (source index) or Dl 
(destination index) registers. 

Instruction Set. The group of mnemonic directions used to control a processor. 

Interpreter. A program that translates high-level language source code into ma¬ 
chine code which is immediately executed. Programs that use an interpreter run 
much slower than programs using a compiler. 

Interrupt. An event, internal or external to the computer, that causes the CPU to 
stop what it is doing and begin execution of an interrupt handler. Interrupts 
generally are used to make the most efficient use of a CPU s time. 

Interrupt flag. The bit in the flag register that indicates whether the CPU should 
handle maskable interrupts. If this flag is set, interrupts are handled. If it is clear, 
interrupts are ignored. 

1QCTL. An acronym for Input/Output Control. A collection of DOS services that 
provide standardized control of block and character devices. These services are 
available through Int 21/44. 

IP. The instruction pointer register. 

LDT. Local Descriptor Table. Used in protected-mode programming of the 80286, 
80386 , or 80486 to detail segment register contents and other descriptors for a 

task. 

LIB.EXE. The library-management software distributed by Microsoft and IBM with 
their assemblers. 

Library. A collection of object-code modules saved in a single file. The assembler 
searches this file during the linking process to resolve external references in the 

main programs. 

linker. A program that combines object files into their final executable state. 

linkin g, The process of resolving external references and address references in 
object code, resulting in machine language instructions that are directly executable 
by the computer. 

Machine language. The senes of binary digits a microprocessor executes to 
perform individual tasks. People seldom (if ever) program in machine language. 
Instead, they program in assembly language, and an assembler translates their 
instructions into machine Language. 

MASM. Macro Assembler, sold and supported by Microsoft. 

MCB. Memory Control Block 
MCGA. Multi-Color Graphics Array. 
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MDA. Monochrome Display Adapter. 

MEMORY. A segment combine type that results in all segments with the same name 
being touted into one segment when United. All addresses and offsets in the re- 

%2Zw,T*Suc“2 ; 1 ffir 

mana^I“ d othe,wt * : 

“ P *" * rtlnaC * method «f depicting the use of an area of computer 

MMU. An acronym for Memory Management Unit, a specialised section of the 

Monochrome. A single color. 

MSW. Machine Status Word. 

v 

NsW. An acronym for Nor a Number. This term is used in conjunction with NPX/FPU 
chips. It represents a floating-point value that does not represent a numerteor 
infinite quantity value. NaN is typicaUy generated as the r^il, of a serious^™ 
and can contain error information that can indicate the source of the error 

NEAR. An assembly language directive that indicates the tvoe 

"«■> conuois howyou 

NPX. Numeric Processor Extension. This is the *0*7, (02(7. or MU7 
coprocessor. ’ 307 numcnc 

Object code A "halfway step" between source code and executable machine 
language, object code consists mosdy of machine language but is nor hi . 
executable by the computer. I, must ter be linked inSSTr 
references and address references. tttemal 

Offset. A distance from a given paragraph boundary in memory. The o&et usualh, 
is given as a number of bytes. ™ CI USua *v 

Overflow flag. The bit in the flag register that indicates whether the signed r~,.w 
of the preceding operation can be represented in the result byte or word ^ 

PAGE. A segment align type that directs the assembler, *er it complete. th*> 
preceding segment, to place the segment at the next available hexadedZS * 
ending in 00. See also Align type , BYTE, PARA, and WORD. ddress 

PARA. A segment align type that directs the assembler, after it comni^,^ ,u 
preceding segment, to place the segment at the next available hexaderi... ■ ^ die 
ending in 0. See also Align type, BYTE, PAGE, and WORD. addre4S 
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Parity’ flag. The bit in the flag register that indicates whether the low-order 8 bits of 
the result contain an even number (PF set) or odd number (PF clear) of bits equal 
to 1. 


Parse. A process of analyzing information to make logical sense of it. Command 
lines are parsed by a command parser or command processor. An assembler parses 
a sourcc-code file to determine what is necessary to create an object file. 

Polling. A method of interrogating external devices to see w’hether they have 
information for or need information from the CPU. 

PRIVATE. A segment combine type that results in the afiFected segment not being 
combined with other segments when linked. See also AT, Combine type, COMMON, 
MEMORY, and STACK. 

PROC. An assembly language directive indicating the start of a procedure. See also 
ENDP. 

Procedure. A self-contained coding segment designed to do a specific task, 
sometimes referred to as a subroutine. 


Protected Mode. An alternative operating mode of the 80286, 80386, and 80486 
chips. Protected mode causes a different use of the segment registers and memory 

than real mode. 

Pseudo-Op A type of operation code that is not a direction to the microprocessor 
but a command for the assembler or linker to foUow when producing the execut¬ 
able file. 


PSP. Program Segment Prefix. 

PUBLIC. A segment combine type that results in all segments with *e same name 
being joined into one segment when linked. All addresses and ofceo in the re- 
suiting segment relate to a single segment regtster. See also AT, Combine type, 
COMMON, MEMORY, PRIVATE, and STACK. , 

Queue. A list of information (or files) waiting to be processed by a program. 


RAM. Random-Access Memory. 


Real Mode. The native operating mode of the 8086/80*8 Also available as the 
default operating mode on later Intel CPUs. 

Register. The data-holding areas, usually 16 bits long, used by the processor in 
performing operations. 


ROM. Read-Only Memory. 

RPL. Requested Privilege Level. 

Rua-time system. A system manager that oversees proper operation of the 
language during program execution. 
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Segment. A particular area of memory. 64K in size 

d^re^' , pK^«: , |ng«i'ab5olutememo^’ , addres^ U * t ° f “ ,he Se8 ™"‘ 

They includfdie C^^B'a^ U s ^?^J il8ned '° COmain a Segm<mi addre5s - 
SI. The source index register. 

SXrfdU ^ o^o^ fla8 equ. t. the lugh-ort., bi. of.. «. 

-*• »“ —» - — 

Source code. The assembly language instructions wnm»„ K . 

assembler translates into object code. ^ umins, that an 

SP. The stack pointer register. 

jSS. The stack segment register. 

Stack. An area of memory set aside for the temporary storage of v.i 
computing environment. The stack operates in a f ^ Ues in a 

environment, only whole words (16 bits) can be pushed on' ™ 8088 * based 

stack. P shed on and Popped from die 

STACK. A segment combine type resulting in all sesmenr* u 
being joined to form one segment when linked All address ^ combine type 
resulting segment are relative to the suck segment reeis^T^ cf** in thc 
initialized to the ending address of the segment ThisromK^ C SP rc » stcr « 
to define the suck area for a programme abo^ £c » 06 WnomttUyhy^ 
MEMORY, PRIVATE, and PUBUC. ' ^° mbtne type, COMMON, 

Status Word. A 16-bit register used in the NPX/FPU to indicate the 

of certain operations. caie ® e status or result 

Subroutine. A self-contz.ned coding segment designed .0 do a .. 
sometimes referred to as a procedure. V ao a s Pec»fic task, 

SVGA. Super Video Graphics Array, a nonstandardized type of di . , 

based on extensions to the VGA standard. * dls P la y adapter 

TASM. Turbo Assembler, sold and supported by Borland International 

Text. A video presentation scheme consisting mostly of letters and 

also Graphics. 6 7 cners and numbers. See 

TLB. Translation Lookaside Buffer, the 80486 on-chip cache for 

TLIB. Turbo Library utility, sold and supported by Boi-lor.^ ^ Cntr * cs ‘ 

i ooriand International. 
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Trap flag. The bit in the flag register that indicates a single-step instruction 
execution mode. If the trap flag is set. a single step interrupt occurs The flag is 
cleared after the assembler executes the next instruction 

VGA. Video Graphics Array, a type of display adapter. 

Virtual Mode. An alternative operating mode of the 80386 and 80486 chips under 
which a protected-mode task can appear to be running in a virtual real-mode 8086 
environment. 

WATT. An assembly language instruction (wait). 

Word. In general usage, two consecutive bytes (16 bits) of data. 

WORD. A segment align type that directs the assembler, after it completes the 
preceding segment, to place the segment at the next available even address. If the 
preceding segment ends on an odd address, WORD effectively is equivalent to 
BYTE. Sec also Align type. BYTE PACE, and PARA 

Zero flag. The bit in the flag register that indicates whether the result of the 
preceding operation is zero If the result is zero, the flag is set. If the result is not 

zero, the flag is clear. 


1 
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Index 


_ Symbols _* 

• character, 208 
% integer flag, 273 
& (ampersand), 242 
(,) comma, 147 

(.) period, 328 

• (asterisk), 169 

• (asterisk) operation code, 239 
+ (plus sign) operation 

code, 239 

• (hypen) delimiter, 95 

• (minus sign) operation 
code, 239 

/ (slash) delimiter, 95 
=: Assign a Value to a Label 
directive, 877-878 
? (question mark), 171 
@ operator, 73 

.186: Enable 80186 Programming 
directive, 878 

.286: Enable 80286 Programming 
directive, 879 
.2860 Enable 80286 Non¬ 
protected-Mode Programming 
directive, 879 

286P: Enable 80286 Protected- 
Mode Programming directive, 
879-880 


.287: Enable 80287 Programming 
directive, 880 

.386: Enable 80386 Programming 
directive, 880 
.3860 Enable 80386 
Nonprotected-Mode Program¬ 
ming directive, 881 
.386P: Enable 80386 Protected- 
Mode Programming direc¬ 
tive, 881 

.387: Enable 80387 Progr amming 
directive, 881, 882 
.486: Enable 80486 Programming 
directive, 882 
.4860 Enable 80486 
Nonprotected-Mode Program¬ 
ming, 882-883 

.486P: Enable 80486 Protected- 
Mode Programming directive, 
883 

.8086: Enable 8086 Pro gr amming 
directive, 883-884 
.8087: Enable 8087 Programming 
directive, 884 
/A option, 131 
/AT option, 119 
/B option, 131 
/FI option, 122 
/Fm option, 122 
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/Gd option, 124 
/H option, 124 
/Sp option, 126 
/St option, 127 
/Sx option, 127 
/V option, 132 
/W option, 128 
/X option, 128 
/Zd option, 129 
/Zf option, 129 
/Zi option, 1?9 
/Zm option, 129 
/Zp option. 129 
/Zs option, 130 
{5L filename} compiler 
directive, 283 

{$L} compiler directives, 292 
32-bit code, 97 
80186 processor, 878, 978 
80286 processor, 728, 978-980 
enable programming, 879-880 
registers, 25 

80386 processor, 729-730, 980-981 
enable programming, 880-882 
registers. 25 

80486 processor, 729, 981-982 
enable programming, 882-883 
registers, 25 

8086 processor, 982-983 
enable programming, 883-884 

8086/8088 flag register, 23 
8086/8088 processor, 728 
8086/8088 register set, 22 

8087 processor, 730, 983, 884 


_ A 

AAA: ASCII Adjust for Addition 
' instruction, 758 
AAD: ASCII Adjust for Division 
instruction, 758-759 
AAM: ASCII Adjust for 
Multiplication instruction, 759 
AAS: ASCII Adjust for Subtraction 
instruction. 759 
absolute 

addresses, 17 
disk reads, 723-724 


disk writes, 724-725 
value, 774 

Absolute Disk Read (Interrupt 
25h) DOS service, 723-724 
Absolute Disk Write (Interrupt 
26h) DOS service, 724-725 
access-rights byte, 822 
accessing parameters 
stacks, 257-260 
values, 272 
adapter cards 

port address ranges, 431 
ports, status, 382 
adapters 

color/graphics, 433-434 
display, 369-378 
EGA, 436-439 
monochrome, 432-433 
VGA, 436-439 
ADC; Add with Carry 
instruction, 760 

Add Full Debugging Data to OBJ 
File option, 157 

Add No Debugging Data to OBJ 
File option, 157 
ADD: Add instruction, 760 
additional Instructions, 871 
additional registers, 25 
address words, stacks, 53 
addressable memory, 16 
addresses, 16, 48 
absolute, 17 

BIOS, extended, 551-552 
calling, 277 
fields, tracks, 451 
handlers, critical error 725 
1/0,413 

international calculations, 309 
location counter, 933 - 934 * 
memory, 328 
register, 15 
ports 

EGA adapters, 436 
hardware, 413, 418-445 
I/O, 416-417 
printers, 439-441 
ranges, 431 
VGA adapters, 436 
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program. 20 
segments. 49. 9" r 7 
string 

calculating. 277 
passing. 299 
terminating. 723 
addressing 
32-bit. 97 
direct, 45-*6 
immediate. 45 
indirect, 46-48 
register, 44 

Adjust Repeat Rate (Interrupt 
I6h, service 03h) BIOS 
service, 558 

adjusting location counter, 
884-885 
alarm, 569-571 
aliases, 67 

Align Segment Data option, 97 
align types, 50 

ALIGN: Adjust the Asscnioler 
Location Counter directive 
884-885 

aligning segments 50 
Allocate Expanded Memory 
command, 181 182 
Allocate Memory (Interrupt 21h, 
service 48h) DOS service, 
675-676 
allocating 

data directives, 874 
expanded memory, 181 
memory, 98, 273, 675-676 
storage space, 888-889 
bytes, 899-900, 941-942, 
999, 1013 

doublewords, 900-901, 908, 
999-1000 

quadwords, 905-906, 
991-992 

words, 907, 1010-1011,1025 
-ALPHA: Place Segments in 
Alphabetic Order directive, 885 
Alphabetic Segment Ordering 
option, 149 
alternate linkers, 120 


Alternate Reset (Interrupt 13h, 
service ODh) BIOS. 524-525 
Alternate Video Select (Interrupt 
lOh. service 12h). 502-503 
ampersand (&), 242 
analysis 

areas, 232 _ 

counting, 224-228 
coverage, 224 
sample, 224 
sampling, 224 
timing, 228-231 
analyzing programs, 224 
AND: Logical AND on Bits 
instruction, 76 >761 
arctangent, partial, 793-794 
ARG: Specify Arguments Passed 
on the Stack directive, 885-886 
arguments 

blank generating errors, 920, 
926, 930-932 
stacks, passing, 885-886 
arithmetic 

assembly-time, 336 
instructions, 33, 732 
shift left, 846 
shift right, 846 

ARPL: Adjust RPL Field of Selector 
instruction, 761 
arrays, graphics, 377 
arrow keys, 185 
ASCII 

character code, MDA, 371 
character set, 1027 
characters, graphics, 395 
files, text, 72,139 
graphics, 395 

strings, displaying, 384-386 
ASM Extension, assembling 
without, 127 
ASM files 
fields, 72 
keywords, 315 
source, 71-73 

Assemble commands, 172-173 
Assemble Only option, 120 

assembler-generated code. 126 
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assemblers 
choosing, 57 

conditional assembly. 79-80 
directives, 59-67, 78-83 
files, 71-78 
QuickAssembler, 314 
MASM, 67-68 
OBJREAD, 269 
options, 116-118, 147-149 
parsing, 57 
PC-oriented, 58 
QuickAssembler, 68-69 
single-pass, 58, 67 
TASM, 143-147 
Turbo Assembler, 69-71 
two-pass, 58 
assembling, 947-948 
BIN files, 336-337 
completion, 155 
conditional, 910-915, 946 
directives, conditional. 121, 
875 

errors, 147 
files, 115-116 

without ASM Extension. 127 
mode, ideal, 944 
subroutines, 143-145 
assembly language, 29 
expanding, 871 
interfacing, 265 
mnemonics, 172 
subroutines, placing in 
strings, 267 
assembly statistics, 132 
assembly-time arithmetic, 336 
assigning 

labels, values, 878 
registers, segment, 886 
ASSUME-. Assign Segment 
Registers directive, 886 
asterisk (•) operation code, 169, 
239 

asynchronous communications 
ports, 441-445 

attribute bytes, 367, 386, 393-394 
color, 387-392 
monochrome, 387 


attributes 

character. 389. 490-492 
color, 271 
interrupt, 284-285 
auxiliary input, 589-590 
Auxiliary Input (Interrupt 21h, 
service 3) DOS service, 589-590 
auxiliary output, 590 
Auxiliary Output (Interrupt 21h. 
service 4) DOS service, 590 


_B_ 

base point (BP) register, 257 
base register, 47 
BASIC (Beginner’s All-purpose 
Symbolic Information Code), 
265-275 

BASICA, 266, 269 
color-secting, 271 
compiled, 278-280 
compiler, 265-266 
GW-BASIC. 266, 269 
interpretive, 266, 275 
Professional Development 
System (PDS), 266 
QBasic, 275-278 
QuickBASIC. 265-266, 275 
statement, 30 
strings, 266 
TurboBASIC. 265-266 
Basic Input/Output System 
(BIOS), 14 
BAT files, 207-208 
batch files 
ML, 132-134 
TASM, 157-159 
batch mode, 97 
baud rate, 441-442 
%B1N: Set Listing-File Object- 
Code Field Width directive, 887 
BIN files 

assembling, 336-337 
converting from OBJ, 337 
linking, 336 
LINK, 337 
TUNIC, 337 
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loading. 332 
restrictions, 328 *' 

STACK segments, 32$ ,* > 

binary image files, 106 
BIND utility, 122 
BIOS (Basic Input/Ourput 
System), 14 

addresses, extended, 551*552 
functions 

categories, 474-573 
macros,.82 ; 

Interrupts, displaying 
characters, 367 
keyboard codes, 1031*1038 
ROM, 26 
video-related 
data. 379 
information, 378 
BIOS services, 26-27,473-476 
Adjust Repeat Rate (Interrupt 
16h,.service 03h), 558 
Alternate Reset (Interrupt I3h, 
service ODh), 524-525 
Alternate Video Select • 

(Interrupt lOh, service 12h), 
502-503 

Boot Process Failure (Interrupt 
18h), 564 

Check Extended Keyboard 
Status (Interrupt l6h, service 
llh), 561 

Control-Break Handler 
(Interrupt lBh), 572-573 
Delay (Interrupt 15h, service 
86h), 546 

Device Close (Interrupt 15h, 
service 81h), 542-543 
Device Open (Interrupt 15h, 
service 80h), 542 
Disable Alarm (Interrupt lAh, 
service 7), 570-571 
EGA/VGA Character Generator 
(Interrupt lOh, service llh), 
501-502 

EGA/VGA Palette Registers 
(Interrupt lOh, service lOh), 

499.5OI 


ESDI Format Hook (Interrupt 
15h, service OFh), 540-541 
Event Wait (Interrupt 15h, 

• service 83h), 544 . 

Extended Communications 
Port Control (Interrupt 14, 
service 5). 536-537 
Extended Communications 
Port Initialization (Interrupt 
I4h, service 4), 535-536 
Format Cylinder and Set Bad 
Sector Flags (Interrupt 13h, 
service 6), 515-516 
Format Disk Track (Interrupt 
13h. service 5), 514-515 
Format Drive from Specified 
Cylinder (Interrupt 13h, 
service 7), 516 
Format ESDI Unit (Interrupt 
13h, service lAh), 530 
Get Clock Counter (Interrupt 
lAh, service 0), 565 
Get Communications Port 
Status (Interrupt I4h, 
service 3), 534-535 
Get Current Video State 
(Interrupt lOh, service 
OFh), 498 

Get Day Count (Interrupt lAh. 

service OAh), 571-572 
Get Equipment Status 
(Interrupt llh), 505-506 
Get Extended BIOS Address 
(Intt.Tupt 15K service Clh), 
551-552 

Get Extended Keyboard Status 
Flags (Interrupt I6h, service 
12h), 561 

Get Extended Keystroke 
(Interrupt l6h, service 
lOh), 560 

Get Floppy Disk Status 
(Interrupt 13h. service 1), 
508-509 

Get Memory Size (Interrupt 
12h). 507 

Get Printer Status (Interrupt 
17h, service 2). 563-564 
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Get System Configuration 
(Interrupt 15h, service COh), 
3-i9-551 

Initialize Communications Port 
(Interrupt 14h, service 0), 
530-532 

Initialize Fixed Disk Table 
(Interrupt 13h. service 9), 
517-518 

Initialize Printer (Interrupt 
17h, service 1). 563 
Joystick Support (Interrupt 
15h. service 8-th). 544-545 
Key-Click Control (Interrupt 
16h, service 04h), 559 
Keyboard intercept Hook 
(Interrupt 15h, service 
4F), 541 

Move Block to/from Extended 
Memory (Interrupt 15h, 
service 8~h). 5-i' , -548 
Park Heads (Interrupt 13h, 
service 19h), 529 
Pointing Device Interface 
(Interrupt !5h. service C2h), 
552-553 

Print Character (Interrupt 17h, 
service 0), 562 

Print Screen (Interrupt 5), 476 
Programmable Option Select 
(Interrupt 15h, service 
C4h), 554 

Protected Mode Switch 
(Interrupt 15h, service 89h) 
548-549 

Read Alarm (Interrupt lAh, 

service 9), 571 

Read Character and Attribute 
(Interrupt lOh, service 8) 
490-491 

Read Cursor Position and Size 
(Interrupt lOh, service 3), 
480-481 

Read DASD Type (Interrupt 
13h. service 15h), 525-526 
Read Data Blocks from 
Cassette (Interrupt 15h, 
service 2), 538-539 


Read Date from Real-Time 
Clock (Interrupt lAh, service 
4). 568-569 

Read Disk Sectors (Interrupt 
13h, service 2). 509-511 
Read Disk-Change Line Status 
(Interrupt 13h, service l6h), 
526-527 

Read Keyboard Character 
(Interrupt I6h, service 0), 
554-555 

Read Keyboard Shift Status 
(Interrupt l6h, service 2h). 
557-558 

Read Keyboard Status 
(Interrupt 16h. service 1). 
556-557 

Read Light Pen Position 
(Interrupt lOh, service 4) 
481-482 

Read Long Sectors (Interrupt 
13h, service OAh), 518-520 
Read Pixel Dot (Interrupt lOh, 
service ODh), 496-497 
Read Real-Time Clock 
(Interrupt lAh. service 
2), 567 

Receive Character (Interrupt 
14h, service 2), 533-534 
Reset Disk Drives (Interrupt 
13h. service 0), 507-508 
Return Drive Parameters 
(Interrupt 13h, service 
8), 517 

Scroll Window Down 
(Interrupt lOh, service 71 
489-490 

Scroll Window Up (Irterrupt 
lOh, service 6), 484-489 
Seek Cylinder (Interrupt 13h 
service OCh), 523-524 
Select Active Display Page 
(Interrupt lOh, service 51 
483-484 Jf 


Set Alarm (Interrupt LAh 

service 6), 569-570 

Sc ; A C ' ock ^nter (Interru 
lAh, service 1 ), 566 


Pt 
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Set Color Palette (Interrupt 
lOh, service OBh). -493--i9-» 

Set Cursor Position (Interrupt 
lOh, service 2). -180 
Set Cursor Size (Interrupt lOh. 

service 1), 479 
Set DASD Type for Format 
(Interrupt 13h, service 17h), 
527*528 

Set Date of Real-Time Clock 
(Interrupt lAh, service 5). 569 
Set Day Count (Interrupt LAh. 

service OBh). 572 
Set Media Type for Format 
(Interrupt 13h. servicel8h). 
528-529 

Set Real-Time Clock (Interrupt 
LAh, service 3). 567-568 
Set Video Mode (Interrupt 1-h. 

service 0), 477-%78 
Size Extended Memory' 
(Interrupt 15h, service 88h). 
548 

SysRq Key Pressed (Interrupt 
15h, service 85h), 545-546 
Terminate Program (Interrupt 
15h, service 82h), 543 
Transmit Character (Interrupt 
I4h, service 1), 533 
TTY Character Output 

(Interrupt lOh, service OEh), 
497*498 

Turn Off Cassette Motor 
(Interrupt 15h, service 1), 538 
Turn On Cassette Motor 
(Interrupt 15h, service 0), 
537-538 

Verify Disk Sectors (Interrupt 
13h, service 4), 513-514 
Warm Boot (Interrupt I9h), 
564-565 

Watchdog Timer (Interrupt 
15h, service C3h), 553 
Write Character (Interrupt 
lOh. service OAh), 492-493 
Write Character and Attribute 
(Interrupt lOh. service 9). 
491-492 


W rite Data Blocks to Cassette 
(Interrupt 15h, service 3). 
539-540 

W rite Disk Sectors (Interrupt 
13h. service 3), 511-513 
Write Long Sectors (Interrupt 
13h. service OBh), 521-522 
Vi rite Pixel Dot (Interrupt lOh, 
service OCh), 495-496 
* Write String (Interrupt lOh, 
service 13h). 503-505 
Write to Keyboard Buffer 
(Interrupt l6h, service 05h). 
559-560 

bit-manipulation instructions. 

3-». 733-734 
bits 

color attribute byte, 387 
doublewords, 21 
monochrome attribute 
bytes, 387 
scanning, 762 
shift left, 860, 861 
shift right, 861-862 
test, 866 
words, 21 

blank parameters, 147 
blanks, writing to screen, 272 
Block Device Changeable? 
(Interrupt 21h, service 44h, 
function 08h) DOS service, 
661-662 

Block Device Read (Interrupt 
21h, service 44h, function 04h) 
DOS service, 658 
Block Device Write (Interrupt 
21h. service 44h, function 05h) 
DOS service, 659 
blocks 
comment 
defining, 55 
defining start, 892 
data, 538-540 
description, 208 
instructions, repeating. 
940-941, 955-956, 997-998, 
1024 
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memory 

comparing, 173 
filling, 175 
moving, 177 
searching, 179*180 
moving to/from extended 
memory, 547-548 
parameter, 256 
repeat, directives. 875 
boot 

drive, 634 
sector, 452 
warm, 564-565 

Boot Process Failure (Interrupt 
18h) BIOS service, 564 
booting failure, 564 
Borland, MAKE command, 
217-220 

bound executable files, 122 
BOUND: Check Array Index 
against Bounds instruction, 
761-762 

branching, <*8-49 
.BREAK: Terminate a REPEAT or 
.WHILE Loop directive, 887-888 
breakpoint interrupt, 194 
breakpoints, 175-176 
browsing, files, source. 123 
BSF: Bit Scan Forward 
instruction, 762 
BSR: Bit Scan Reverse 
instruction, 762 

BSWAP: Swap 32-Bit Byte Order 
instruction, 763 
BT: Bit Test instruction, 763 
BTC: Bit Test and Complement 
instruction, 763-764 
BTR: Bit Test and Reset 
instruction, 764 
BTS: Bit Test and Set 
instruction, 764 
buffered input, 594 
Buffered Input (Interrupt 21h, 
service OAh) DOS service, 594 
buffers 

clearing, 595-596 
flushing, 719-720 
keyboard, writing to, 559-560 


si 2 e, 131 
video. 367 

bugs, see also debugging, 165 
built-in high-level language 
debuggers, 168 

built-in macros, 211-212, 218-220 
bus, locking, 826 
BYTE: Allocate a Byte of Storage 
Space directive, 888-889 
bytes 

access-rights, loading, 822 
attribute, 367, 386-394 
boundary, 129 
data, 40 

machine language program 
instruction. 40 
offset, 270-271 
outputting to port, 178 
R (restore). 336 
retrieving from port, 176 
S (save), 336 
setting, 848-860 
storage space, allocating, 
888-889, 941-942, 999. 1013 
strings 

input from pons, 807 
scanning for, 847 
values, character attributes, 
485-489 

words, converting from, 765 


_ C 

/c option, 120 

/Cp option, 120 
. /Cu option, 120 
/Cx option, 120 
C language 
compilers, 307 
C+ + , interfacing, 307-325 
libraries, 137 
strings, storage, 320 
caches, invalid. 809-810, 867-868 
calculations 
addresses 

international, 309 
string, 277 
floating-point, 363 
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calculators, hexadecimal, 176 
CALL ABSOLUTE statement, 277 
CALL statement, 272, 332 
CALL xBase command, 327 
CALL: Perform Subroutine 
instruction, 765 
callable subroutines, 473 
calling 

addresses, 277 
subroutines, 765 
Cancel Redirection (Interrupt 
21h, service 5Fh, function 04h) 
DOS service, 705*706 
canceling redirection, 705, 706 
cards, adapter, port status, 382 
carry flag 

clearing, 766 
complement, 767 
setting, 863 
case differences, 120 
cassettes 

data blocks, reading/writing, 
538-540 
motor, 537-538 
categories, directives, 872 
CATSTR: Concatenate Strings 
directive, 889-890 
CBW: Convert Byte to Word 
instruction, 765 
CDQ. Convert Doubleword to 
Quadword instruction, 766 
CGA (Color Graphics Adapter), 
372-374 

Change Handle Count (Interrupt 
21h, service 67h) DOS service, 

i\9 

Change Memory-Block Allocation 
(Interrupt 21h, service 4Ah) 
DOS service, 677 
character input with echo, 588 
Character Device Read (Interrupt 
21h, service 44h, function 02h) 
DOS service, 656 
Character Device Write (Interrupt 
21h, service 44h function 03h) 
DOS service, 657 
Character Input with Echo 
(Interrupt 21h, service 1) DOS 
service, 588 


Character Input without Echo 
(Interrupt 2 lh, service 8), 
592-593 
characters 
attributes 

byte values, 485-489 
reading, 490-491 
writing, 491-492 
converting, 716 
displaying, 387 

BIOS interrupts, 367 
DOS interrupts, 367 
video memory, 382-384 
generators, RAM, 375 
graphics, ASCII, 395 
interrupt, writing, 492-493 
invisible, 387 

keyboard, reading, 554-555 
output, 589 
printing, 562 

with attributes, 389 
receiving, 533-534 
single, displaying, 382 
strings, output, 593-594 
symbol, limiting, 124 
transmitting, 533 
TTY, 497-498 
underline, 310 

Check Extended Keyboard Status 
(Interrupt l6h, ser, 561 
Check for Character Waiting 
(Interrupt 21h, service OBh) 
DOS service, 595 
Check Purity of 286/386 Code 
option, 154 
classes, 49-51 

CLC: Clear Carry Flag instruction, 
766 

CLD: Clear Direction Flag 
instruction, 766 
Clear Buffer and Get Input 
(Interrupt 21h, service), 595-596 
CLEAR command, 273 
clearing 

buffers, 595-596 
carry flag, 766 
direction flag, 766 
exceptions, 776-790 
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flags. 24 

interrupt flag, 767 
task-switched flag. 767 
CLI: Clear Interrupt Flag 
instruction, 767 
Clipper 

code, machine, 342 
CodeView, 342 
debugging, 342 
files, extensions. 341 
interfacing, 341-353 
source files. 341 
subroutines, interfacing, 
342-351 

Turbo Debugger, 342 
clock, 565-569 
clock cycles, 368 
Close File (Interrupt 21h, service 
3Eh) DOS services, 647 
Close File. Using FCB (Interrupt 
21h, service lOh), 599-600 
closing 

devices, 542-543 
files, 647, 599-600 
Clrhome function, 321 
CUTS: Clear Task-Switched Flag 
instruction, 767 
CMC: Complement Carry Flag 
instruction, 767 


CMP: Compare instruction, 76J 
CMPSB: Compare Strings, Byte 
for-Byte instruction, 768 
CMPSD: Compare Strings, 

Doubleword-for-Doubleworc 
instruction, 768-769 
CMPSW: Compare Strings, Wor 
for-Word instruction, 769 
CMPXCHG: Compare and 
Exchange instruction, 769-77 
.CODE: Define Beginning of 
pogrom Code directive, 890 

32-bit, 97 


assembler-generated, 126 

define beginning, 890-891 
labels, directives, 874 
machine. Clipper, 342 


object 

field width, 88 7 
files, 57 

relocatable, 67, 86 
optimizing, 1004 
disabling. 973 
overlays, 87 
segments 
naming, 310 
packing. 103 
padding. 104 
size. 451-452 
source 

inserting, 953-954 
listing, 959, 970-971, 1026 
pure, 132 
translating, 5P 
viewing, 193-194 
code generating macros, 972, 1026 
code pages, global, 718 
code segment register <CS), 24 
codes 

error, ML. 134-135 
exit, MASM 5.1, 134 
keyboard 
BIOS, 1031-1038 
controller, 1039-1042 
machine, 30 
operation 


asterisk (*), 239 
minus sign (-), 239 
plus sign (+), 239 


CODESEG: Define Beginning of 
Program Code directive, 890-891 
CodeView, 184-185, 198-204 
Clipper, 342 
commands, 185 
compatible file, 129 
screen, 199 
coding inline, 314-315 
color, 41 


attribute bytes. 392 
attributes, 271 
clearing screen, 271 
Palette, 493-494 
Color Graphics Adapter (CGA) 
3 / 2-374 9 
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color/graphics adapter. 433*434 
colors, background/foreground, 
388-389 

COMM. Define a Communal 
Variable directive, 891-892 
comma (.). 147 
command line. 208 
LINK, 138-139 
MASM. 115 
command sets. 170 
command-line options. 116-118 
commands 


CLEAR, 273 
CodeView. 185 
compound, 30 
DEBUG 

Allocate Expanded Memory. 


181-182 


Assemble, 172-173 
Compare. 173 
Deallocate Expanded 
Memory. 182 
Dump, 1 7 3-174 
Enter, 174 

Expanded Memory Status, 
182-184 
Fill, 175 

Go, 175-176, 197 

Hexadecimal Arithmetic. 176 

Input, 176 
Load, 177 

Map Expanded Memory, 182 
Move, 177 
Name, 177 
Output, 178 
Proceed, 178 


Quit. 179 
Registe- l 79 
Search. 1 

Trace. 180. IS"/”* 


Write. 181 


GOSUB, 52 
labels. 31 
UNK, 95 


LEM. 18-19 
modifiers. 211. 220 


Open, 113 
options, 116 

Programmer’s VC orkbench, 113 

Register, 197 

RETURN.52 

RIP, 195 

spacing, 31 

Turbo Debugger, 186 

xBase 

CALL. 327 
LOAD. 327 

RELEASE MODULE. 328 
commas, parameters. 138 
comment blocks 
defining. 55 
defining start. 892 
COMMENT directive. 55. 72 
comment field, ASM files. '2 
comment lines, description 
files. 209 

COMMENT: Define the Stan of a 
Comment Block directive, 892 
comments. 55, 72 
common segments, grouping, 9*-» 
communal variables, defining, 
891-892 

communications ports 
asynchronous, 441-445 
control, 536-537 
initializing, 530-536 
status, 534-535 
Compare command. 173 
comparing, 768 
integers, 781 
memory blocks, 173 
strings. 768-769 
compatibility 

downward, 13, 8“ 
forced. 129 
MASM 4.0, 963 
MASM 5.1,963 
disabling, 972 
options. 130-131 
upward. 13 

versions, specifying. 1021 
Compile File option. 115 
compiled BASIC. 2“8-280 
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compiler directive 
<*F). 292 
(JL). 292 

filename). 28J 
compilers 30*31 
BASIC. 265*266 
C. 30** 

single-pass 121 
compiling files. 115 
complement carry flag. 767 
complete segment control. 8-3 
complex data opes directives. 8"* 
component bvtes 23 
compound commands. 30 
concatenation, strings 889*890 
%CONDS L,s, All Conditional 
Statements directive. 892 895 
conditional 

wmblv. '9-80 910*915. 9*6 
directives. "9. 121. 8-5 
errors, directives. 8* T 5 
program execution. 909*91 4 
9**-9*5 
statements 
false. 156 

listing. 893. 958 960 971 
1003. 1015 
true. 968 

conditionals, false. 127 
configuration 
•witches. 421 
system. 549*551 
console, direct. 591*592 
CONST: Define Beginning of 
Constant Data directive. 893 
constant data, defining 
beginning. 893 

constant values labels. 918 
constants, nunw.ic. 733 
CONTINUE Modify Execution of 
• repeat or WHILE loop 

directive, 89**895 
control 

flag. Instructions, 735 
flt»w. directives, 875 
fli°bal. dirccuves. 873 
listing directives. 876 
page, luting hies. 983*98* 


. - , 

JS 






processor. Instructions -35 
segments 

complete, directives 873 
simplified, directives 8-3 
stnngs. directive 6"6 
transferring. 24. 35. 943 
words. 751*752 
loading. 786 
storing. 792 

Control M arning Messages 
option. 156 

Control-Break Handler (In..., 
IBh) BIOS service. 572*573 
control-transfer instructions 734 
controlled loops 

beginning. 1022*1024 
declaring, 996 - 09 ? 
controllers 

3259 interrupt controller 
418-419 

codes, keyboard. 1039-1042 

controlling 

communications port, 536-537 
disk dnves. disk base table. 449 
keyboard. 421.426-428 
program. 46^-469 
speaker. * 28-430 
software. 1 * 

■witches, configuration 421 

word wrap. luting file# ' 
controls, luting 
restoring, 985-986 
saving temporarily. 991 
conventions. 123-124 
Convert ASCI12 String (Interrupt 
2lh_ service 65h function 22h) 
DOS service. 717-718 
Convert Character (Interrupt 
21h. service 65h. function 20h) 
DOS service -16 
Convert String (Interrupt 21h, 
service 65h. function 21h) DOS 
service. 716-717 
converting 

bytes to words. 765 
character, 716 
doublewords 10 ouadwurda 
766 
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strings, 716-718 
words 

to doublewords, 770 
to extended doubleword, 770 
coordinates, x-y, 386 
coprocessors, numeric, 363-365. 

727, 967-968, 984-985 
copyright messages. 125 
cosine, 777, 797 
counters 

clock. 565-566 
location 

address, even. 933-934 
adjusting, 884-885 
counting analysis, 224-228 
coverage analysis, 224 
CPU, determing type, 357 
CPUASM function, 358-360 
Create a Listing File option, 152 
Create an Expanded Listing File 
option, 152 

Create Code for Numeric 
Coprocessors option, 154 
Create Debugger-compatible File 
option, 98 

Create File (Interrupt 21h, service 
3Ch) DOS service, 644-645 
Create File (Interrupt 21h, servico 
5Bh) DOS service, 697-698 
Create File, Using FCB (Interrupt 
21h, service l6h) DOS service, 
607-608 

Create Overlays option, 103 
Create Program Segment Prefix 
(PSP) (Interrupt 21h, service 
26h) DOS service, 620-621 
Create Subdirectory (Interrupt 
2lh, service 39h) DOS service, 
642-643 

Create Temporary File (Interrupt 
21h, service 5Ah) DOS service, 
696-697 
creating 

dependency files, 220-221 
Wes, 607-608, 644-645, 698 
EXE, 137 
library, 241 
temporary, 696-697 


with linker, 88-89 
libraries, 240-244 
listing files, 152 
subdirectories. 642-643 
CREF: Enable Cross-Referencing 
directive, 895 

%CREF: Enable Cross-Referencing 
directive, 896 

%CREFAJLL: Cross-Reference All 
Variables directive, 896 
%CR£FREF: Cross-Reference Only 
Referenced Variables directive, 
896-897 

%CREFUREF: Cross-Reference 
Only Unreferenced Variables 
directive, 897 

critical-error handler address, 723 
Critical-Error Handler Address 
(Interrupt 24h) DOS.service, 723 
cross-referencing. 895 
disabling, 968-969, 1026 
listing files, 149-150 
unreferenced variables, 897 
variables, 896 

%CTLS: Include Listing-Control 
Directives in the, 897 
Ctrl-Brcak Handler Address 
(Interrupt 23h) DOS service, 723 
CurOff, 286 
current drive, 609-610 
current stack pointer (SP), 259 
cursor 

moving, 185 
new, 286 
position, 481 
saving, 297 
setting, 480 

positioning. 82-83, 270, 342 
shape, 342 
size, 479-481 

turning ofl/on, 286, 290-291, 
330-332 

CWD: Convert Word to 
boubleword Instruction, 770 
CWDE: Convert Word to 
Emended Doubleword 
instruction, 770 
cylinder, 451 
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D 


/D option, 121 

DAA: Decimal Adjust for Addition 
instruction, 771 
DAS: Decimal Adjust for 
Subtraction instruction, 771 
.DATA: Define Beginning of Data 
Segment directive, 898 
.DATA?: Define Beginning of 
Uninitialized Data Segment 
directive, 898 
DATA statements, 269 
data 

allocation directives. 874 
areas, defining, 172 
bytes, 40 

constant, beginning, defining, 

893 

enumerated, defining, 917 
manipulation, 263 
overhead, 262 
placing on stacks. 839-840 
returning via pointers, 318-320 
segments 
far, 939-940 
naming, 310 
padding, 104 
uninitialized, 1016-1017 
stacks, removing. 838 
storage, 40-44 

structures, defining, 1006-1008 
transferring to/from ports, 415 
types, complex, directives, 874 
data blocks 

reading from cassette, 538-539 
writing to cassette, 539-540 
data segment register (DS), 24 
DATA statement, 270 
data-allocation directives, 41-44 
Data-Transfer instructions, 33, 731 
DATASEG: Define Beginning of 
Data Segment directive, 899 
day count, 571-572 
DB: Allocate a Byte of Storage 
Space directive, 899-900 
dBASE, xBase, 327 
dBASE III + , interfacing, 327-339 


dBASE IV, interfacing, 336 
DD: Allocate a Doubleword of 
Storage Space directive, 900-901 
Deallocate Expanded Memory 
command, 182 
DEBUG, 187 

command set, 170 
commands 

Allocate Expanded Memory, 
181-182 

Assemble, 172-173 
Compare, 173 
Deallocate Expanded 
Memory, 182 
delimiters, 170 
Dump, 173-174 
Enter. 174 

Expanded Memory Status, 
182-184 
Fill, 175 
Go. 175-176 

Hexadecimal Arithmetic, 176 
Input, 176 
Load, 177 

Map Expanded Memory, 182 

Move, 177 

Name, 177 

Output, 178 

Proceed, 178 

Quit. 179 

Register, 179 

Search, 179-193 

Trace, 180, 195-196 

Unassemble, 180-181 192 

Write, 181 

errors, detecting, 171 
loading, 187-190 
quitting, 179 
registers, displaying, 197 
DEBUG software debugger 
169-171 

debuggers, 98, 165 

CodeView, 166, 198-204 
DEBUG, 166 
hardware, 167-168 
high-level language, built-in, 168 
software, 167 
DEBUG, 169-171 
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high-level language, 168 
source-level, 184 
Turbo Debugger, 166, 204-206 
debugging, 157, 165-166 
Clipper, 342 
DEBUG, 187 
interrupt, 194 
source-level linkers, 86 
TEST.EXE, 190-191 
DEC. Decrement instruction, 
771-772 

decimals, adjusting, 771 
declaring prototypes, 317, 988 
decrementing, 771-772 
default 

drives, setting. 597 
files, Linking, 137 
libraries, 102 
defaults, radix, 992-993 
Define an Identifier option. 

150-151 

defining 

beginning of code, 890-891 
comment blocks, 55, 892 
communal variables, 891-892 
constant data beginning, 893 
data 

areas, 172 
enumerated, 917 
structures, 1006-1008 
unions, 1017-1018 
identifiers, 121, 150-151 
. macros, beginning, 962 
names, modules, 967 
pointer types, 1016 
records, 996 

segments, beginning, 898-899, 
1000-1002 
symbols, 956-957 
tables, method, 1011-1012 
text macros, 1014 
variables, local, 961 
definitions 
MultiUse, 
external, 937 
global, 942-943 
macro, 211 
deleting, 990 


delay, 546 

Delay (Interrupt 15h, service 
86h) BIOS service, 546 
Delete File (Interrupt 21h, service 
41h) DOS service, 649-650 
Delete File, Using FCB (Interrupt 
21h, service 13h) DOS service, 
603-604 
deleting 

definitions, macro, 990 
files, 649-650 
FCB, 603*604 
delimiters, 118, 170 
- (hypen), 95 
/ (slash), 95 
dependency 

blocks. 221-222 
files 

creating, 220-221 
MAKE, 208 
lines, 209 

%DEPTH: Set Listing-File Depth- 
Field Width directive. 901 
description 
blocks 

evaluating, 208 
outfile/infile relationship, 
208 

files 

comment lines, 209 
NMAKE, 209 

descriptor table register, 728 
interrupting, 862 
storing, 862 

Device Close (Interrupt 15h. 
service 81h) BIOS service, 
542-543 

device drivers, 14, 27 
Device Open (Interrupt l5h, 
service 80h) BIOS service, 542 
devices 

closing, 542-543 
in-circuit, 167 
open, 542 
redirect, 704-705 
DF: Allocate 6 Bytes of Storage 
Space directive, 901, 902 
dictionaries, extended, 100 
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direct access storage device, see 
disk drive 

direct addressing, 45-46 
Direct Character Input without 
Echo (Interrupt 21h, service 7) 
DOS service, 592 
direct console, 501-592 
Direct Console IX) (Interrupt 
21h, service 6) DOS service, 
591-592 
direction flag 
clearing, 766 
setting, 863 
directives, 37, 78*83 

=: Assign a Value to a Label, 
877-878 

.186: Enable 80186 Program¬ 
ming, 878 

.286: Enable 80286 Program¬ 
ming, 879 
286C: Enable 80286 
Nonprotected-Mode 
Programming, 879 
286P: Enable 80286 
Protected-Mode Program¬ 
ming, 879-880 
.287: Enable 80287 Program¬ 
ming, 880 

.386: Enable 80386 Program¬ 
ming, 880 

.3860 Enable 80386 
Nonprotected-Mode 
Programming, 881 
386P: Enable 80386 
Protected-Mode Program¬ 
ming. 881 

.387: Enable 80387 Program¬ 
ming, 881-882 

.486: Enable 80486 Program¬ 
ming, 882 

.4860 Enable 80486 
Nonprotected-Mode 
Programming, 882-883 
486P: Enable 80486 
Protected-Mode Program¬ 
ming, 883 

.8086: Enable 8086 Program¬ 
ming, 883-884 


.8087: Enable 8087 Program¬ 
ming, 884 
aliases, 67 

ALIGN: Adjust the Assembler 
Location Counter, 884-885 
ALPHA: Place Segments in 
Alphabetic Order, 885 
ARG: Specify Arguments 
Passed on the Suck, 885-886 
assembler supported, 59-67 
assembly, conditional, 121, 875 
ASSUME: Assign Segment 
Registers, 886 

%BIN: Set Listing-File Object- 
Code Field Width, 887 
blocks, repeat, 875 
.BREAK: Terminate a .REPEAT 
or .WHILE Loop, 887-888 
BYTE: Allocate a Byte of 
Storage Space, 888-889 
categories, 872 

CATSTR: Concatenate Strings, 
889-890 

.CODE: Define Beginning of 
Program Code, 890 
code labels, 874 
CODESEG: Define Beginning 
of Program Code, 890-891 
COMM: Define a Communal 
Variable, 891-892 
COMMENT, 55, 72 
COMMENT: Define the Start of 
a Comment Block, 892 
compiler 
{SF},29? 

{$L filename), 283 
{IL>, 292 

conditional assembly, 79 
%CONDS: List All Conditional 
Sutemcnts, 892-893 
.CONST: Define Beginning of 
Consunt Data, 893 
CONST: Define Beginning of 
Constant Dau, 893 
.CONTINUE: Modify Execution 
of a REPEAT or .WHILE, 
894-895 
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control 
global, 873 
listing, 876 
segments, 873 
strings, 876 
.CREF: Enable Cross- 
Referencing, 895 
%CREF: Enable Cross- 
Referencing, 896 
%CREFALL. Cross-Reference 
All Variables, 896 
%CREFREF: Cross-Reference 
Only Referenced Variables, 
896-897 

%CREFUREF. Cross-Reference 
Onr> Unreferenced 
Variables, 897 
%CTLS: Include Listing- 
Control Directives in the 
listing File, 897 
.DATA. Define Beginning of 
Data Segment, 898 
DATA?: Define Beginning of 
Uninitialized Data Seg, 898 
data types, complex, 874 
data-allocation, 41-44, 874 
DATASEG: Define Beginning of 
Data Segment, 899 
DB: Allocate a Byte of Storage 
Space, 899-900 
%DEPTH: Set Listing-File 
Depth-Field Width, 901 
DD: Allocate a Doubleword of 
Storage Space, 900-901 
DF: Allocate 6 Bytes of Storage 
Space, 901-902 
DISPLAY: Output a String to 
the Screen, 902 
.DOSSEG: Order Segments in 
Microsoft High-Level- 
Language, 903 

DOSSEG: Order Segments in 
Microsoft High-Level- 
Language, 903-904 
DP: Allocate 6 Bytes of Storage 
Space, 904-905 
DQ: Allocate a Quadword of 
Storage Space, 905-906 


DT: Allocate 10 Bytes of 
Storage Space, 906 
DW Allocate a Word of 
Storage Space, 907 
DWORD: Allocate 
Doubleword of Storage 
Space, 908 

ECHO: Output a String to the 
Screen, 908-909 
ELSE: Conditional Assembly, 

910 

.ELSE: Conditional Program 
Execution, 909 

.ELSE1F: Conditional Program 
Execution, 910-912 
ELSE1F: Conditional Assembly, 
912 

EMUL: Use Floating-Point 
Emulation, 912-913 
END. Designate Source-File 
End, 913 

END1F. Conditional Program 
Execution, 913-914 
ENDIF: Conditional Assembly, 

914- 915 

ENDM: End a Macro or Loop, 
915 . 

END?. End a Procedure, 

915- 916 

ENDS: End a Segment or 
Structure, 916 
ENDW: End a .WHILE Loop, 

916- 917 

ENUM: Define Enumerated 
Data, 917 

EQU : Assign a Constant Value 
to a Label, 917-918 
ERR: Force an Error To Occur, 
918 

ERR: Force an Error To 
Occur, 919 

.ERR1: Force an Error To 
Occur on Assembler 
Pass 1,919 

ERR2 . c orce an Error To 
Occur on Assembler Pass 2, 
919-920 
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.ERRB: Generate an Error If 
Argument Is Blank, 920 
.ERRDEF: Generate an Error If 
Symbol Is Defined. 920-921 
.ERRDIF: Generate Error If 
Strings Are Different, 
921-922 

.ERRDLFI: Generate Error If 
Strings Are Different, 922 
.ERRE: Generate Error If 
False, 923 

.ERRIDN: Generate Error If 
Strings Are Identical, 
923-924 

.ERR1DN1: Generate Error If 
Strings Are Identical, 924-925 
ERRIF: Generate Error If True, 
925 

ERRIF1: Force an Error To 
Occur on Assembler Pass, 925 
ERRLF2: Force an Error To 
Occur on Assembler P~cs, 926 
ERRIFB: Generate an Error If 
Argument Is Blank, 926 
ERRIFDEF: Generate an Error If 
Symbol Is Defined, 926-927 
ERRIFDIF: Generate Error If 
Strings Are Different, 927 
ERRIFDIF!: Generate Error If 
Strings Are Different, 928 
ERRLFE: Generate Error If 
False, 928 

ERRIFIDN: Generate Error If 
Strings Are Identical, 929 
ERRJFIDNI: Generate Error If 
Strings Are Identical, 

929-930 

ERRJLFNB: Generate an Error If 
Argument Is Not Blank, 930 
ERRIFNDEF: Generate an 
Error If Symbol Is Not 
Defined, 931 

ERRNB: Generate an Error If 
Argument Is Not Blank, 
931-932 

ERRNDEF: Generate an Error If 
Symbol Is Not Defined, 932 


ERRNZ: Generate Error If 
True, 933 

errors, conditional, 875 
EVEN: Adjust the Assembler 
Location Counter to an Even 
Address, 933 
EVENDATA: Adjust the 
Assembler Location Counter 
to an Even Address, 934 
EXIT: Specify Program Exit 
Point, 934 

EX1TCODE: Specify Program 
Exit Point. 934-935 
EX1TM. Exit a Macro 
Immediately, 935 
EXTERN: Declare a Label as 
Being Defined in Another 
Module. 935-936 
EXTERNDEF: MultiUse 
External Definition, 937 
EX I kN: Declare a Label as 
Being Defined in Another 
Module, 937-939 
.FARDATA: Define Beginning 
of Far Data Segment, 939 
FARDATA: Define Beginning of 
Far Data Segment, 940 
.FARDATA?: Define Beginning 
of Uninitialized Far Data 
Segment, 939-940 
flow control, 875 
FOR; Repeat a Block of 
Instructions, Using an 
Argument List, 940-941 
FORC: Repeat a Block of 
Instructions, Using a String 
941 

FWORD: Allocate 6 Bytes of 
Storage Space, 941-942 
GLOBAL: MultiUse Global 
Definition, 942-943 
GOTO: Transfer Control. 943 
GROUP: Specify Common 
Segment Grouping. 944 
IDEAL: Enter Ideal Assembly 
Mode, 944 

.IF: Conditional Program 
Execution, 944-945 
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IF: Conditional Assembly, 946 
IF 1: Assemble if on Assembler 
Pass l. 946-947 
1F2: Assemble if on Assembler 
Pass 2, 947 

1FB: Assemble if Blank, 947-948 
1FDEF: Assemble if Defined, 948 
1FDIF: Assemble if Strings Are 
Different, 949 

1FD1FI: Assemble if Strings Are 
Different (Case Insensitive), 
949-950 

1FE: Assemble if False, 950 
IFIDN: Assemble if Strings Are 
Identical, 950-951 
IFIDN1: Assemble if Strings Are 
Identical (Case Insensitive), 
951-952 

IFNB. Assemble if Argument Is 
Not Blank, 952 
IFNDEF: Assemble if Not 
Defined. 952-953 
%INCL: Enable Listing of 
INCLUDE Files. 953 
INCLUDE: Insen Source Code 
from Another File. 953-954 
INCLUDELIB: Specify Library 
for Linker To Use, 954 
1NSTR: Return a Position of 
One String in Another, 
954-955 

INVOKE: Execute a Procedure. 

955 
IRP, 81 

1RP: Repeat a Block of 
Instructions, Using an 
Argument List, 955 
IRPC, 82 

I RPC: Repeat a Block of 
Instructions, Using a String, 

956 

JUMPS: Enable Jump 
Stretching, 956 
LABEL: Define a Symbol, 
956-957 

•LALL. Enable Listing of All 
Macro Expansions, 957 


LARGESTACK: Specify 32-Bit 
Stack Pointer, 957-958 
.LFCOND. List All Conditional 
Statements, 958 
%L1NUM: Set Listing-File Line- 
Number Field Width, 958 
%LIST: Enable Source-Code 
Listing, 958-959 
.LIST: Enable Source-Code 
Listing. 959 

.LISTALL: Include Everything 
in Listing File, 959 
.LISTIF, 127 

.LIST1F: List All Conditional 
Statements, 960 
listing control, excluding, 969 
LISTMACRO. List Only Macros 
that Generate Code, 960 
•LISTMACROALL: Enable 
Listing of All Macro 
Expansions, 960 
LOCAL, 81 

LOCAL: Define Local Variables, 
961 

LOCALS: Enable Local 
Symbols, 961 
macro, 81, 875 
MACRO: Define the Start of a 
Macro, 962 

%MACS: Enable Listing of All 
Macro Expansions, 962 
MASM 6.0, 37-38 
MASM: Enable MASM 4.0 
Compatibility, 963 
MASM51: Enable MASM 5.1 
Compatibility, 963 
miscellaneous, 877 
MODEL. Specify Memory 
Model, 966 • 

MODEL: Specify Memory 
Model, 963*966 
MSFLOAT: Specify Microsoft 
Floating-Point Format, 966 
MULTERRS: Enable Multiple 
Error Reporting, 966 
NAME. Define the Module 
Name. 967 
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%NEWPAGE: Advance Listing 
File to New Page, 967 
NMAKE; 213-215 
.N087: Disable Numeric 
Coprocessor Programming. 
967-968 

%NOCONDS: List True 
Conditional Statements, 968 
•NOCREF: Disable Cross- 
Referencing, 968-969 
%NOCREF: Disable Cross- 
Referencing, 968 
%NOCTLS: Exclude Listing- 
Control Directives from the 
Listing File. 96.9 
NOEMUL: Don’t Use Floating* 
Point Emulator, 969 
96NOINCL: Disable Listing of 
INCLUDE Files, 970 
NOJUMPS: Disable Jump 
Stretching. 970 
%NOLIST: Disable Source- 
Code Listing, 970 
.NOLIST: Disable Source-Code 
Listing, 971 
NOUSTIF: List True 
Conditional Statements, 971 
NOUSTMACRO: Disable 
Macro Listing, 971 
NOLOCALS: Disable Local 
Symbols, 972 

%NOMACS: List Only Macros 
that Generate Code, 972 
NOMASM51: Disable MASM 
5.1 Compatibility, 972 
NOMULTERRS: Disable 
Multiple Error Reporting 

973 

NOSMART: Disable Code 
Optimization, 973 
&NOSYMS: Disable Symbol 
Table in Listing File, 973 
%NOTRUNC: Control Word- 
Wrapping in the Listing File 

974 

NO WARN: Disable Warnings 
974-975 ** 


OPTION: Set Assembler 
Processing Parameters, 
975-9~7 

ORG. Specify Starting Segment 
Address, 977 

%OUT: Output a String to the 
Screen, 977-978 
P186: Enable 80186 
Programming, 978 
P286: Enable 80286 
Programming. 978-979 
P286N: Enable 80286 
Nonprotected-Mode 
Programming. 979 
P286P: Enable 80286 
Protected-Mode 
Programming, 979 
P287: Enable 80287 
Programming, 979-980 
P386: Enable 80386 
Programming, 980 
P386N: Enable 80386 
Nonprotected-Mode 
Programming, 980 
P386P. Enable 80386 
Protected-Mode 
Programming, 981 
P387: Enable 80387 
Programming, 981 
P486: Enable 80486 
Programming, 981-982 
P486N: Enable 80486 

Nonprotected-Mode 
Programming, 982 
P8086: Enable 8086 
Programming, 982-983 
P8087: Enable 8087 
Programming, 983 
PAGE, 126 

PAGE: Listing-File Page 
Control, 983-984 
%PAGESI2E: Set Listing-File 
Page Dimensions, 984 
%PCNT: Set Listing-File 
Address-Field Width, 984 
PNOS7: Disable Numeric- 

9S4 P 0« C <" SOr Pro * ramn >‘"g. 
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POPCOSTKXT. Restore 
Assembler Environment. 984 
•?„POHLCTL: Restore Listing 
Controls. 985-986 
preprocessing. 21? 

PROC: Start a Procedure. 

986*98“' 

procedures. 8"-* 
processor specification. 8"2 
PROTO: Declare Procedure 
Prototype. 988 
pseudooperators. "2 
PUBLIC: Declare Symbols as 
PUBLIC. 988-989 
PUBL1CDLL: Declare Symbols 
as PUBLIC for Dynamic Link 
Libraries. 989 
PURGE. 82 

PURGE: Delete Macro 
Definition. 990 
PUSHCONTEXT: Save 
Assembler Environment. 990 
%PUSHLCTL: Temporarily 
Save Listing Controls. 991 
QUIRKS: Enable Handling of, 
MASM Quirks. 991 
QWORD: Allocate a Quadword 
of Storage Space. 991-992 
.RADIX: Specify the Default 
Radix. 992 

RADIX; Specify the Default 
Radix 993 

REAL10: Allocate 10 Bytes of 
Storage Space for an 80-Bit 
Floating Point Number. 995 
REAL4: Allocate a Doubleword 
of Storage Space for a 32-Bit 
Floating Point Number, 

993- 994 

REAL8: Allocate a Quadword of 
Storage Space for a 64-Bit 
Floating Point Number, 

994- 995 

RECORD. Define Records. 996 
repeat blocks. 8 7 5 
REPEAT; Declare the 
Beginning of a Controlled 
Loop. 996-99" 


RF.PEA’I I'epc.it .i Block. of 
Instruction*. ° 1 '” 

RE FI. 81 

KEPT: Repeat ;t Block of 
Instructions. 998 
SALL: Disable Macro Listing. 

998 

SBYTE: Allocate a Signed Byte 
of Storage Space. 999 
scope, 8"-» 

SDWORD: Allocate a Signed 
Doubleword of Storage 
Space. 999-1000 
SEGMENT: Define Beginning 
of a Segment. 1000-1002 
.SEQ: Place Segments in 
Sequential Order. 1002 
SEQ Place Segments in 
Sequential Order. 1002-1003 
.SFCOND: List True Condition¬ 
al Statements. 1003 
SIZF.STR: Return the Length of 
a String. 1003 

SMALLSTACK. Specify 16-Bit 
Suck Pointer, 1004 
SMART. Enable Code 
Optimization, 1004 
STACK: Define Beginning of 
Stack Segment. 1005 
.STACK; Define Beginning of 
Stack Segment. 1004-1005 
STARTUP: Specify Program 
Entrv Point. 1005 
STARTUPCODE: Specify 
Program Entry Point. 1006 
STRUC: Define a Data 
Structure. 1006-1007 
STRUCT. Define a Data 
Structure. 1007-1008 
SLiBSTR: Return a Substring. 

1008-1009 
SUBTITLE. 126 
SUBTITLE: Specify Listing-File 
Subtitle. 1009 

%Sl BTTL: Specify Listing-File 
Subtitle. 1010 
SITJTTL: Specify* Listing-File 
Subtitle. 1009-1010 
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SWORD: Allocate a Signed 
Word of Storage Space, 
1010-1012 

%SYMS: Enable Symbol Table 
in Listing File, 1011 
TABLE: Define a Method 
Table, 1011-1012 
%TABSIZE: Set Listing-File 
Tab-Stop Width, 1012 ' 

TASM 3.0. 38-39 
TBLPTR: Force Table-Pointer 
Inclusion, 1012-1013 
TBYTE: Allocate 10 Bytes of 
Storage Space, 1013 
%TEXT: Set Listing-File Source- 
Field Width, 1014 
TEX' EQU: Define a Text 
M cro, 1014 

TFCOND: Switch State of 
Conditional-Statement 
Listings. 1014-1015 
TITLE, 12 7 

%T1TLE: Specify Listing-File 
Title, 1015 

TITLE: Specify Listing-File 
Title. 1015 

%TRL'NC: Control Word- 
Wrapping in the Listing File, 
1016 

TYPEDEF: Define a Pointer 
Type. 1016 

UDATASEG: Define Beginning 
of Uninitialized Data 
Segment, 1016-1017 
UFARDATA: Define Beginning 
of Uninitialized Far Data 
Segment, 1017 

UNION: Define a Data Union. 

1017- 1018 

UNTIL: End a .REPEAT Loop 

1018- 1019 

UNTILCXZ: End a REPEAT 
' Loop, 1019-1020 
USES: Specify Registers To 
Save, 1020-1021 
VERSION, 155 
VERSION: Specify Version 
Compatibility, 1021 


visibility, 8”-* 

WARN: Enable Warnings, 
1021-1022 

.WHILE: Declare the Beginning 
of a Controlled Loop, 
1022-1024 

WHILE: Repeat a Block of 
Instructions, 1024 
WORD; Allocate a Word of 
Storage Space, 1025 
XALL: List Only Macros that 
Generate Code, 1025-1026 
XCREF: Disable Cross- 
Referencing, 1026 
XLIST: Disable Source-Code 
Listing, 1026 
directories 
paths, 674-675 
setting. 644 

subdirectories, 642-644 
Disable Alarm (Interrupt L\h. 

service 7) BIOS service. 570-5 7 l 
disabling 

interrupts. 778-790 
macro listings. 971 
symbols, local, 972 
disk base table. 449-450 
Disk Operating Sytem (DOS). 14 
.disks 

accessing. DOS functions, 
447-448 

changing during program. 104 
drives, 447-469 
controlling. 449 
resetting, 507-508 
files, writing to, 181 
floppy 

formatting, 447 
status. 508-509 
formatting. 447-448 
reads, absolute. 723-724 
resetting. 596 
sectors 

loading. 177 
reading. 509-511 
verifying. 513-514 
writing. 511-513 
writing to disk, 181 


Scanned with CamScanner 




Index 1075 


tracks 

formatting. 51-*-515 
sectors. 450 

writes, absolute. 724-* 7 25 
displacement value. 4 7 
display 

adapters. 369-378 
memory-mapped. 367 
type. 378-381 
video. 367-368 

Display Help Information option, 
95.149 

Display Progress of Linking 
Process option, 101 
Display Source Lines with Errors 
option, 157 

DISPLAY: Output a String to the 
Screen directive. 902 
displaying 

characters, 387 

BIOS interrupts, 367 
DOS interrupts. 367 
single. 382 

video memory, 382-384 
help information. 95-97 
lines, error, 132 
memory locations, contents. 173 
strings, ASCII, 384-386 
DIV: Divide instruction. 772 
division, 772 

Do Not Associate Groups option, 
102 

Do Not Generate Any Listing File 
option, 106 

Do Not Ignore Case Differences in 
Exports and Imports option. 97 
Do Not Ignore Case Differences 
option, 98 

Do Not Pack Code Segments 
option, 103 

Do Not Translate FAR Calls 
* option. 102 
Do Not Use Default Libraries 
option, 102 
DOS 

extenders, 14 

functions, disk access, 447-448 


interrupts, displaying 
characters. 36“' 
services. 27. 5' 7 5-586. 7 26 
version number. 630-631 
DOS (Disk Operating System). 14 
DOS services 

Absolute Disk Read (Interrupt 
25h), 723*724 

Absolute Disk Write (Interrupt 
26h), 724-725 
Allocate Memory (Interrupt 
2 Ih. service 48h). 675-676 
Auxiliary Input (Interrupt 21h. 

service 3), 589-590 
Auxiliary Output (Interrupt 
21h, service 4), 590 
Block Device Changeable? 
(Interrupt 21h, service 4-*h, 
function 08h), 661-662 
Block Device Read (Interrupt 
21h, service 44h, function 
04h). 658 

Block Device Write (Interrupt 
21h. service 4«*h. function 
05h). 659 

Buffered Input (Interrupt 21h, 
service OAh). 594 
Cancel Redirection (Interrupt 
21h, service 5Fh. function 
04h), 705-706 

Change Handle Count (Interrupt 
21h, service 67h), 719 
Change Memory-Block 
Allocation (Interrupt 21h, 
service 4Ah), 677 
Character Device Read 
(Interrupt 21h, service 44h, 
function 02h), 656 
Character Device Write 
(Interrupt 21h, service 44h 
function 03h), 657 
Character Input with Echo 
(Interrupt 21h, service, 588 
Character Input without Echo 
(Interrupt 21h. service, 
592-593 
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htcl* lor Character W aiting 
<Interrupt 2lh. service tUlh). 
595 

t.lcar Buffer and Get Input 
(Interrupt 21 h. service. 

59 5->90 

Close Fi>* 'terrupt 2Jh. 

servit ..to. 0-t” 

Close I L'sing FCB 
(Inte; pt 21 h. service lOh). 
599-6 ) 

Comer. ASCJIZ String 
(Interrupt 21h. service 65h. 
function 22h), ^17-18 
Convert Character (Interrupt 
21h. service 65h, function 
20h). 716 

Convert String (Interrupt 21h, 
service 65h, function 21h), 
716-717 

Create File (Interrupt 21h, 
service 3Ch). (hh-6h5 
Create File (Interrupt 21h, 
service 5Bh). 697-698 
Create File, l'sing FCB 
(Interrupt 21h, service 16h), 
607-608 

Create Program Segment Prefix 
(PSP) (Interrupt 2lh service 
26h), 620-621 

Create Subdirectory (Interrupt 
21h, service 39h). 642-6-»3 
Create Temporary File 
(Interrupt 21h, service 5Ali). 
696-697 

Crirical-Error Handler Address 
(Interrupt 2*h), 723 
Ctrl-Break Handier Address 
(Interrupt 23h>, 723 
Delete File (Interrupt 2lh, 
service 4lh), 649-650 
Delete File, Using FCB 
(Interrupt 21h, service 13h» 
603-604 

Direct Character Input without 
Echo (Interrupt 2lh. service 
7). 592 


Direct Console I O (Interrupt 
2 i li. service 0) 591-592 
Duplicate File Handle 
(Interrupt 21h. service -»5h). 
6“s 

Extended Open Create File 
(Interrupt 2Jh. service 6Ch). 
~ 2()~22 

File Access Control (Interrupt 
21h. service 5Ch). 698-699 
Flush Buffer (Interrupt 2lh, 
service 68h). ”19-~20 
Force Handle Duplication 
(Interrupt 21h. service 46h). 
6‘ T 3-6* T 4 

Free Allocated Memory (Interrupt 
21h. service 49h). 6"6 
Generic IOCTL Block Device 
Request (Interrupt 21h. 
service 4-th, function ODh), 
66* r -669 

Get Address of InDOS Flag 
(Interrupt 21h. service 3-th). 
635-636 

Get Allocation Strategy 
(Interrupt 21h, service 58h. 
function OOh), 68"-688 
Get Boot Drive Code 
(Interrupt 21h. service 33h. 
function 05h). 63^ 

Ger Ctrl-Break Flag (Interrupt 
21h. service 33h. function 
OUh). 633 

Get Current Drive (Interrupt 
21h. service 19h). 609-610 
Get Default Disk Parameter 
Block (Interrupt 21h. service 
lFh). 613-615 
Get Device Information 
(Interrupt 21h. service 44h. 
function OOh). 652-654 
Get Directory Path (Interrupt 
21h, service 47h). 6 T 4-675 
Get Disk Free Space (Interrupt 
21h, service 36h). 63"’-638 
Get Disk Parameter Block 
(Interrupt 21h, service 32h) 
632-633 
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Get Disk Transfer Area 

(Interrupt 2lh. service 2Fh). 

630 

Get DOS Version Number 
(Interrupt 21h. service 30h), 

630-631 

Get DOS Version Number 
(Interrupt 21 h. service 33h. 
function 06h), 633 
Get Double-Byte Character Set 
(Interrupt 21h. service 65h. 
function 07h). 714-715 
Get Extended Country 

Information (Interrupt 21h. 
service 65h, function Olh). 
-<n-709 

Get Extended-Error 

Information (Interrupt 21h. 
service 59h). 691-695 
Get FAT (File Allocation Table) 
Information for Default 
Drive (Interrupt 21h. service 
lBh). 611-612 

Get FAT Information for Drive 
(Interrupt 21h. service lCh), 
612-613 

Get File Size, Using FCB 
(Interrupt 21h, service 23h), 
617-618 

Get Filename Uppercase Table 
(Interrupt 21h. service 65h, 
function Onb). 711-712 
Get High-Memory Link Status 
(Interrupt 21h. service 58h, 
function 02h), 689-690 
Get Input Status (Interrupt 
21h, service 44h. function 
06h). 660 

Get Interrupt Vector (Interrupt 
21h. service 35h). 636-63" 
Get Invalid Filename Character 
Table (Interrupt 21. service 
65h, function 05h). 712-713 
Get Logical Device Map 
(Interrupt 21h. service 44h. 
function OEh), 669-6"0 


Get Machine Name (Interrupt 
21h. service 5Eh. function 
OOh). 700- T 01 

Get Output Status (Interrupt 
21h, service 44h. function 
O^h), 660-661 

Get Printer Setup (Interrupt 
2 lh. service 5Eh, function 
03h). 702-703 

Get Program Segment Prefix 
(PSP) Address (Interrupt 
21h. service 62h). 706 
Get PSP Address (Interrupt 
21h. service 51h), 685 
Get Redirection List Entry 
(Interrupt 21h, service 5Fh. 
function 02h), 703-704 
Get Return Code of a 

Subprocess (Interrupt 21h, 
service 4Dh). 681-682 
Get Son Sequence Table 
(Interrupt 21h. service 65h, 
function 06h). 713-714 
Get System Date (Interrupt 
2lh service 2Ah). 626 
Get System Time (Interrupt 
21h. service 2Ch). 627 
Get Uppercase Table 

(Interrupt 21h, service 65h. 
function 02h), 710 
Get Verify Setting (Interrupt 
21h, service 54h), 685-686 

Get/Set Country-Dependent 
Information (Interrupt 21h. 
service 38h). 638-642 
Get Set File Attnbutes 

(Interrupt 2lh. service 43h). 
651-652 

Get Set File Date and Time_ 
(Interrupt 21h. service 5 h), 
687 

Gei'Set Global Code pa 8 e 
(Interrupt 21h. service 66n). 
718 

Handl** Generic Code-Page 
Switching (Interrupt 2 lh. 
serv ice -»-»h. function OCh), 
660 - 66 " 
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Handle Local Remote 
Determination (Interrupt 
21h. service 44h. function 
OAh). 664-665 

Load Overlay (Interrupt 21h, 
service 4Bh, function 03h). 
679 

Load Program (Interrupt 21h, 
service 4Bh. function OOh), 
6 7 7-678 

Logical Device Local Remote 
petermination (Interrupt 
21h. service 4*fh. function 
09h). 662-663 

Move File Pointer (Interrupt 
21h, service 42h), 650-651 

Multiplex Interrupt (Interrupt 
2Fh), 726 

Open File (Interrupt 21h, 
service 3Dh), 645-646 

Open File, Using FCB 
(Interrupt 21h, ser-^e OFh), 
598-599 

Output Character (Interrupt 
21h. service 2), 589 

Output Character String 
(Interrupt 21h. service 9). 
593*594 

Parse File Name, Using FCB 
(Interrupt 2lh. service 29h), 
624-625 

Printer Output (Interrupt 21h, 
service 5), 590-591 

Process Terminate (Interrupt 
21h, service 4Ch), 681 

Query Drive (Interrupt 21h, 
service 44h, function 1 lh). 
671-672 

Query Handle (Interrupt 21h, 
service 44h, function 10hL 
671 

Random Read. Using FCB 
(Interrupt 21h. service 21h), 

615- 616 

Random Write, Using FCB 
(Interrupt 21h, service 22h). 

616- 617 


Read File (Interrupt 21h, 
service 3Fh). 64 7 -6-»8 
Read Random Record(s), Using 
FCB (Interrupt 21h. service 
2 T h). 621-622 
Redirect Device (Interrupt 
21h, service 5Fh, function 
03h). 704-705 
Remove Subdirectory 
(Interrupt 21h. service 3Ah), 
643*644 

Rename File (Interrupt 21h, 
service 56h), 686 
Rename File, Using FCB 
(Interrupt 21h, service 17h), 
608-609 

Reset Disk (Interp’ot 21h, 
service ODh). 596 
Search for First File-Name 
Match (Interrupt 2lh, 
service 4Eh), 682-683 
Search for First File-Name 
Match. Using FCB (Interrupt 
2lh, service llh), 600-602 
Search for Next File-Name 
Match (Interrupt 21h, 
service 4Fh). 684 
Search for Next File-Name 
Match, Using FCB (Interrupt 
21h, service 12h), 602-603 
Sequential Read. Using FCB 
(Interrupt 21h, service I4h), 
604-605 

Sequential Write. Using FCB 
(Interrupt 21h, service 15h), 
606-607 

Set Allocation Strategy 
(Interrupt 21h, service 58h, 
function Olh), 689 
Set Ctrl-Break Flag (Interrupt 
21h, service 33h, function 
Olh), 633-634 
Set Default Drive (Interrupt 
21h, service OEh), 597 
Set Device Information 
(Interrupt 21h, service 44h, 
function Olh), 654-655 
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Set Directory (Interrupt 2lh. 

service 3Bh), 6-44 
Set Disk Transfer Axea (DTA) 
(Interrupt 2lh. service lAh). 

610 

Set Execution State (Interrupt 
21h. service 4Bh. function 
05h). 680 

Set Extended-Error Values 
(Interrupt 21h. service 5Dh, 
function OAh), 699*700 
Set High-Memory Link Status 
(Interrupt 21h. service 58h. 
function 03h). 690 
Set Interrupt Vector (Interrupt 
21h. service 25h). 620 
Set Logical Device Map 

(Interrupt 2lh. service -nh. 
function OFh). 6“’0 
Set Printer Setup (Interrupt 
21h. service 5Hh, function 
02h). 701 “02 
Set PSP Address (Interrupt 
2lh, service 50h). 68-4*685 
Set Random Record Field in 
FCB (Interrupt 21h. service 
24h). 619 

Set Sharing Retry Count 
(Interrupt 21h. service 44, 
function OBh), 666 
Set System Date (Interrupt 
21h, service 2Bh), 626-627 
Set Time (Interrupt 21h, 
service 2Dh), 628-629 

Set Verify Flag (Interrupt 2lh. 

service 2Eh). 629-630 
Terminate Address (Interrupt 
22h), 723 

Terminate and Stay Resident 

(Interrupt 21 h. service 3lh), 

631*632 

Terminate and Stay Resident 
(Interrupt 27h), 726 
Terminate Program (Interrupt 
20h). 587 

Terminate Program (Jnterrupt 
21h, service 0). 587*588 


Write File (Interrupt 21h. 

service 40h). 648-6-49 
W'rite Random Record(s). 

Using FCB (Interrupt 21h. 
service 28h). 622-624 
.DOSSEG; Order Segments in 
Microsoft High-Level-Loop 
directive. 903 

DOSSEG: Order Segments in 
Microsoft High-Level- 
Language, 903*904 
dot prompt, 328 
doublewords, 21 

extended, converting from 
words, 770 

quadwords. converting to, 766 
storage space, allocating as, 
900-901. 908. 999-1000 
strings, scanning for, 847-848 
words, converting from, 770 
downward compabillty. 13. 8 
DP: Allocate 6 Bytes of Storage 
Space directive. 904-905 
DQ: Allocate a Quadword of 
Storage Space directive, 

905-906 
drives. 447-469 
boot, 634 
current, 609*610 
default, setting. 597 
formatting, 516 
heads, parking. 529 
parameters, 517 
querying, 671-672 
DS register, 822-823 
DT: Allocate 10 Bytes of Storage 
Space directive. 906 
Dump command, 173-174 
DUP operator, 42 
Duplicate File Handle (Interrupt 
21h. service 45h) DOS service, 


iplicating handles, 673-674 

V: Allocate a Word of Storage 
Space directive. 907 
WORD: Allocate a Doubleworf 
of Storage Space directive. 908 
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_ E_ 

ECHO: Output a String to the 
Screen directive, 908-909 
editors, linkage, see tinkers 
EGA (Enhanced Graphics 
Adapter), 374-376. 437-439 
display inodes, 375 
port addresses, 436 
EGA/VGA Character Generator 
(Interrupt lOh. service llh), 
501-502 

__ EGA/VGA Palette Registers 
(Interrupt lOh. service lOh), 
499-501 

.ELSE: Conditional Program 
Execution directive. 909 
ELSE: Conditional Assembly 
directive. 910 

.ELSEIF: Conditional Program 
Execution directive. 910-912 
ELSEIF: Conditional Assembly 
directive, 912 
EMUL: Use Floating-Point 
Emulation directive. 912-913 
Emulate Floating-Point 
Instructions option. 151 
emulation, floating-point. 

912-913 

emulators 

floating-point, 969 
in-circuit, 167 
math. 123 

Enable 32-bit processing option. 
97 

END Designate Source-File End 
directive, 913 

.END1F: Conditional Program 
Execution directive. 913-914 
ENDIF: Conditional Assembly 
directive, 914-915 
ENDM: End a Macro or Loop 
directive. 915 

ENDP: End a Procedure directive 
915-916 

FNDS: End a Segment or 
Structure directive. 916 


ENDW: End a WHILE Loop 
directive, 916-91 -7 
Enhanced Graphics Adapter 
(EGA), 37-4-376 
Enter command. 17-i 
ENTER: Make Stack Frame for 
Procedure Parameters 
instruction, 772-773 
entry point, specifying, 
1005-1006 

ENUM: Define Enumerated Data 
directive, 917 

enumerated data, defining. 917 
environment 
hardware, 13 
restoring, 985 
saving, 990 
software, 14 
storing, 792 
variables 

INCLUDE. 128 
library, 137 
macro definitions, 213 
restoring. 786 
/Ep option. 121 

EQU: Assign a Constant Value to 
a Label directive, 917-918 
equates, 40 
color, 41 

.ERR: Force an Error To Occur 
directive, 918 

ERR: Force an Error To Occur 
directive, 919 

ERR1: Force an Error To Occur 
on Assembler Pass directive 

919 

.ERR2: Force an Error To Occur 
on Assembler Pass directive 

919- 920 

.ERRB: Generate an Error If 
Argument Is Blank directive, 

920 

.ERRDEF: Generate an Error If 
Symbol Is Defined directive, 

920- 921 

ERRDIF: Generate Error If 
Strings Are Different directive, 

921- 922 
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ERRDIFI: Generate Error If 
Strings Are Different directive. 

922 

ERRE. Generate Error If False 
directive. 923 

ERR1DN: Generate Error If 
Strings Are Identical directive, 

923- 924 

.ERRIDNI: Generate Error If 
Strings Are Identical directive. 

924- 925 

ERRIF: Generate Error If True 
directive, 925 

ERRIF 1: Force an Error To Occur 
on Assembler Pass 1 directive, 

925 

ERRIF2: Force an Error To Occur 
on Assembler Pass 2 directive, 

926 

ERRIFB: Generate an Error If 
Argument Is Blank directive, 

926 

ERRIFDEF: Generate an Error If 
Symbol Is Defined directive, 
926-927 

ERR1FDIF: Generate Error If 
Strings Are Different directive, 
927 

ERRIFDIFI: Generate Error If 
Strings Are Different (Case 
Insensitive) directive, 928 
ERR1FE: Generate Error If False 
directive, 928 

ERRIF1DN: Generate Error If 
Strings Are Identical directive, 
929 

ERRIFIDNI: Generate Error u 
Strings Are Identical (Case 
Insensitive) directive, 929-930 
ERRIFNB: Generate an Error If 
Argument Is Not Blank 
directive, 930 

ERRIFNDEF: Generate an Error II 
Symbol Is Not Defined 
directive, 931 

.ERRNB: Generate an Error If 
Argument Is Not Blank 
directive, 931-932 


ERRNDEF. Generate an Error If 
Symbol Is Not Defined 
directive. 932 

ERRNZ: Generate Error If True 
directive, 933 
error messages, 138 
errors 

assembling. 147 
code, 134-135 
conditional, directives, 875 
detecting. 171 
extended. 691-695 
file assembly, 116 
forcing, 918-920, 925-926 
generating 

blank arguments, 920, 926, 
930-932 

different strings, 921-922 
• expressions, true, 925,933 
expressions, false, 923,928 
strings, different, 927-928 
strings, identical, 925-925, 

929 

symbols, defined, 920-921, 

‘ 926-932 

lines, displaying, 132 
reading, multiple, 973 
reporting, multiple, 966 
warnings, 128 

ES register, loading, 823-824 
ESC: Escape instruction, 773 
escape, 773 

ESDI Format Hook (Interrupt 
15h, service OFh) BIOS service, 
540-541 

evaluating description blocks, 

208 

EVEN: Adjust the Assembler 
Location Counter to an Even 
Address directive, 933 
EVENDATA: Adjust the Assembler 
Location Counter to an Even 
Address directive, 934 
Event Wait (Interrupt 15b, service 
83n) BIOS service, 544 
exceptions, clearing, 776, 

789-790 on* 

exchanging registers, 80} 
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Exclude Tables from Listing File 
option, 153 

excluding tables from listing 
Files, 153 

executable (EXE) files, 90, 137 
bound, 122 
specifying, 122 
type, specifying, 106 
executing statements, machine 
language, 175 
execution 

loop, modifying. 894-895 
procedures, 955 
program, conditional, 909 - 914 , 
944-945 
state, 680 

Execution Profile window, 232 
EXIT: Specify Program Exit Point 
directive, 934 
exit codes, MASM 5.1, 134 
exit point, 934-935 
EXITCODE: Specify Program Exit 
Point directive, 934-935 
exiting macros immediately, 935 
EX3TM: Exit a Macro Immediately 
directive, 935 
expanded memory’, 14 
allocating, 181 
mapping, 182 
Expanded Memory Status 
command, 182-184 
expansions, macro, 960-962 
expressions 

false, errors, 923. 928 
true, errors, 925, 933 
Extend-System routine, 347-348 
extended 

dictionaries. 100 
errors, 691-695 
instructions. 871 
keyboards. 561 
keystrokes, 560 
memory, 14 

moving blocks to'from, 
547.548 
size, 548 

Extended Communications Port 
Control (Interrupt 14h, service 


5) BIOS service, 536-53 7 
Extended Communications Port 
Initialization (Interrupt I4h. 
service 4) BIOS service, 
535-536 

Extended Open/Create File 
(Interrupt 21h, service 6 Ch) 
DOS service. 720-722 
Extended-System routine 
functions, 351-353 
extenders, DOS, 14 
extensions 

ASM, assembling without, 127 
files 

Clipper. 341 
.MAP. 137 
xBase, 328 
source files, C. 318 
EXTERN: Declare a Label as 
Being Defined in Anoth, 
935-936 

external definitions. MultiUse 
93 7 

external references 

library files. 137 4 

unresolved, 245 

EXTERNDEF: MultiUse External 
Definition directive, 937 .** 

extra segment register (ES), 24 
EXTRN': Declare a Label as Being 
Defined in Another, 937.939 


_F_ 

{SF} compiler directive, 292 

/F option. 118. 121 

F 2 XM 1 2x-l (x is superscript) 
instruction. 773-774 
FABS; Absolute Value instruction, 
774 

FADD: Add Real instruction, 774 
FADDP: Add Real and POP 
instruction. 774-775 
false conditionals, 127 
far data segments, 939-940 
FARDATA: Define Beginning of 
Far Data Segment directive, 939 


Scanned with CamScanner 


♦it 






index 1083 


t 



« 




* 


i 



« 


.FARDATA?: Define Beginning of 
Uninitialized Far Data Segment 
directive. 939-940 
FAR pointers, 309-311 
FAR procedure, 52-53. 257-258 
far returns, 172 

FARDATA: Define Beginning of 
Far Data Segment directive, 940 
FAT (file allocation table), 452 
/Fb option, 122 

FBLD: BCD Load instruction, 775 
FBSTP: BCD Store and POP 
instruction, 775 
FCHS: Change Sign instruction, 
775-776 

FCLEX: Clear Exceptions with 
WAIT instruction, 776 
FCOM: Compare Real instruction, 

776 

FCOMP: Compare Real and POP 
instruction, 777 

FCOMPP: Compare Real and POr 
Twice instruction, 177 
FCOS: Cosine instruction, 777 
FDECSTP: Decrement Stack 
Pointer instruction, 778 

• FDISI: Disable Interrupts with 

WAIT instruction, 778 
FDIV: Divide Real instruction, 

778 \y 

FDIVP: Divide Real and POP 
instruction, 779 
FDIVR: Divide Real Reversed 
instruction, 779 
FDIVRP. Divide Real Rcv *" cd 
and POP Instruction, 779-/8U 
/Fe option, 122 
FENI: Enable Interrupts with 
WAIT instruction, 780 

• FFREE: Free Register instruction, 

780 

FIADD: Integer Add instruction, 
780-781 

FICOM: Integer Compare 
instruction, 781 
F1COMP: Integer Compare and 
POP instruction, 781 
FIDIV: Integer Divide 


instructions, 782 
FIDIVR: Integer Divide Reversed 
instruction. 782 
fields 

ASM files, 72 
track address, 451 
FILD: Integer Load instruction, 
782-783 

File Access Control (Interrupt 
21 h, service 5Ch) DOS service, 

698-699 ^ 

file allocation table (FAT), 452 
File pull-down menu, 114 
filenames, uppercase tables, 
711-712 
files 

access control, 698-699 
ASM, 71-72^ 
assemblers, 71-78 
assembling, 113-116 
errors, 116 

without ASM Extension, 127 
BAT, 207-208 
batch 

ML, 132-134 
TASM, 157-159 
BIN. 337-339 

assembling, 336-337 
converting from OBJ, 337 
linking, 336-337 
loading, 332 
restrictions, 328 
STACK segments, 329 
binary image, 106 
closing, 647 
FCB, 599-600 
code, object, 57 
CodeView-compatible, 129 
compiling, 115 
converting to Inline 
statements, 298 
creating, 607-608,644-645. 
697-698 
linker, 88-89 
debugging. 189 
deleting. 649-650 
FCB. 603-604 
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dependency, 220-222 
description, 209 
executable (EXE) 
bound, 122 
creating, 137 
EXE. 90 
specifying, 122 
type. 106 
extensions 
Clipper. 3-41 
MAP, 137 
xBase. 328 

handles, duplicating. 673 
include, 125, 151 

listing, disabling. 953. 970 
input, OBJ. 89 
library, 240 
creating, 2*1 
external references, 137 
Quick Library QLB. 2 7 9 
UNK EXE, 137 
linking. 136*137 
list, 13 f , 242 

map, 90-91 

listing 

address field width, 984 
advancing, 967 
creating, 152 
cross-references, 149-150 
depth field, 901 
expanded, 152 
line number width. 958 
LST, 73-78 
object code, 887 
page control. 983*984 
page dimensions. 984 
source field, width. 1014 
subtitles. 1009-1010 
symbol table. 973. 1011 
tab stop width, 1012 
tables, 153 
titles, 1015 

word-wrap, 974, 1016 
loading to memory. 177 
MAKE, 317 

dependency files, 208 
MAP, 90-91 
map lisung, 12 2 


module-definition, 138 
names 

parsing. 624-625 
root, 137 
OBJ. 85-89 

convening to BIN, 337 
debugging data, 157 
object, 122 

line numbers, 129, J57 
object-code, linking. 137 
OBJ READ. BAS. 270 
opening. 645-646 
FCB. 598-599 
output. OBJ, 73 
packing. 99 

paths, include files, 124 
pointers, moving. 650-651 
reading. 647-6*8 
renaming 608-609. 686 
response, 139-1*0 
libraries. 246-2*8 
TLi.NK, 161-162 
source 
ASM, 72-73 
browsing, 123 
Clipper, 341 
end, designate, 913 
extensions. 318 
source browser, 123 
source listing. 122 
target. 209 
temporary 

creating. 696-697 
VM TMP, 92 

TEST.EXE. debugging, 190-191 
text, ASCII, 72, 139 
virtual memory, 92 
VM.TMP, 92 
wnung, 648-649 
writing to disk, 181 
Fill command, 175 
filling blocks, memory. 175 
FIMUL- Integer Multiply 
instruction. 783 
FiNCSTP: Increment Stack 
Pointer instrucuon, 783 
FIN IT: Initialize Processor with 
WAIT instruction, 783-784 
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first-pass listings. 125 
FIST: Integer Score instruction. 
784 

FISTP: Integer Store and POP 
instruction. 784 
FISUB: Integer Subtract 
instruction, 784-785 
FISUBR: Integer Subtract 
Reversed instruction, 785 
fixed disk table, 517-518 
fixups, 153 
flag Instructions, 24 
flag- and processor-control 
instructions, 36, 735 
flags, 22-23 

8086/8088 flag register, 23 
bad sector, 515*516 
carry 

clearing, 766 
complement, 767 
setting, 863 
clearing, 24 
direction 

clearing, 766 
setting, 863 

extended, placing on stacks, 
841 

extended keyboard status, 561 

integer, 273 

interrupt 

clearing, 767 
setting, 864 
IOPL, 361 
register, 746 
setting, 24 
stacks 

placing in, 840-841 
removing, 839 
task-switched, clearing, 767 
values 

displaying, 179 
testing, 24 

verify, setting, 629-630 
zero, 24 

FLD: Load Real instruction, 785 
Pl-Dl: Load 1.0 instruction. 786 
FLDCW: Load Control Word 
instruction, 786 


FLDENV: Load Environment 
instruction. 786 
FLDL2E: Load log,e instruction. 

787 

FLDL2T: Load log, 10 instruction, 

787 

FLDLG2: Load log, 0 2 instruction, 

787 

FLDLN2: Load log l 2 instruction, 

788 

FLDPI: Load n (pi) instruction, 

788 

FLDZ: Load 0.0 instruction, 788 
float-type variables, 310 
floating point unit (FPU), 727 
floating-point, 123. 151 
calculations. 363 
emulation, 912-913.969 
format, specifying. 966 
floppy disks 
formatting, 447 
status, 508-509 
flow, control, directives, 8 / 5 
Flush Buffer (Interrupt 21h, 
service 68h) DOS service. 
719-720 

flushing buffers, 719-720 
FMUL. Multiply Real instruction. 
789 

FMULP: Multiply Real and POP 
instruction, 789 
FNCLEX: Clear Exceptions 
instruction, 789*790 
FND1SI: Disable Interrupts 
instruction, 790 
FNENI: Enable Interrupts 
instruction, 790 
FNINIT: Initialize Processor 
instruction, 790-791 
FNOP: No Operation instruction, 

791 

FNSAVE: Save State instruction. 

791 , 
FN^TCW. Store Control word 

instruction, 792 
I NSTI NV Store IWtrdWNfnt 
iimtitiittim, 
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FNSTSW: Store Starus Word 
instruction, 792- _T 93 
/Fo option. 122 
- FOR: Repeat a Block of 
Instructions, Using an 
Argument List directive, 
940-941 

FORC: Repeat a Block of 
Instructions. Using a String 
directive, 941 
Force Handle Duplication 
(Interrupt 21h, service 46h) 
DOS service, 673-674 
formal parameters, 81 
format 

ASM source files, 72 
floating-point, 966 
Format Cylinder and Set Bad 
Sector Flags (Interrupt 13h, 
service 6) BIOS service. 515-516 
Format Disk Trac.’ - (Interrupt 
13h, service 5) BIOS service, 
514-515 

Format Drive from Specified 
Cylinder (Interrupt 13h, service 
7) BIOS service, 516 
Format ESDI Unit (Interrupt I3h, 
service lAh) BIOS service, 530 
formatting 

disks, 447-448 
drives. 516 
parameters, 256 
routine, 452-467 
tracks, 450-452 
disks, 514-515 
Fox n ro, interfacing, 327-339 
FPATAN: Partial Arctangent 
instruction, 793 
/Fpi option, 123 
FPREM: Partial Remainder 
instruction, 793-794 
FPREM 1: Partial Remainder, IEEE 
version instruction, 794 
FPTAN: Partial Tangent 
instruction, 794 
FPU (floating point unit), 727 
/FR option, 123 
/Fr option, 123 


Free Allocated Memory' (Interrupt 
21h, service 49h) DOS service. 
676 

FRNDINT: Round to Integer 
instruction, 794-795 
FRSTOR; Restore State 
instruction, 795 
FS register, loading, 824 
FSAVE: Save State with WAIT 
instruction, 795 
FSCALE: Scale instruction, 796 
FSETPM: Set Protected Mode 
instruction, 796 
FSIN: Sine instruction, 796 
FSINCOS: Sine and Cosine 
instruction, 797 

FSQRT: Square Root instruction. 

797 

FST: Store Real instruction. 797 
FSTCW: Store Control Word with 
WAIT instruction, 798 
FSTENV: Store Environment with 
WAIT instruction, 798 
FSTP: Store Real and POP 
instruction, 798 
FSTSW: Store Sums Word with 
WAIT instruction, 799 
FSUB: Subtract Real instruction, 
799 

FSUBP: Subtract Real and POP 
instruction, 799-800 
FSUBR: Subtract Real Reversed 
instruction, 800 

FSUBRP: Subtract Real Reversed 
and POP instruction, 800 
FTST: Test instruction, 800-801 
FUCOM: Unordered Compare 
instruction, 801 
FUCOMP: Unordered Compare 
and POP instruction, 801 
FUCOMPP: Unordered Compare 
and POP Twice instruction. 802 
function subprograms, 302-305 
functions 
BIOS 

categories, 474-573 
macros, 82 
Clrhome, 321 
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CPU.ASM. 358-360 
declaring as routines. 302 
DOS. disk access. •*4*’-448 
Extended-System routine. 
351*353 

memory-management, 15 

NPX, 731 

scanf(). 199 

starus(), 200 

SYS(). 332 

user-defined (UDF), 341 
FWAIT: CPU Wait instruction, 802 
FWORD: Allocate 6 Bytes of 
Storage Space directive. 

941-942 

FXAM: Examine instruction, 

802- 803 

FXCH: Exchange Registers 
instruction, 803 

EXTRACT: Extract Exponent and 
Significand instruction, 803 
FYL2X: Y*log,X instruction, 

803- 804 

FYU2XP1: Y*log,(X+l) 
instruction, 804 


G "V 

/Gc option, 123 
GDT register 
loading, 824 
storing. 860 
general registers 
popping, 838 
pushing, 840 

Generate Detailed Segment Map 
option, 105 

Generate Overlay Code option, 153 
Generate Overlay Code with 
Phar-Lap-Style Fixups option, 
154 

Generic IOCTL Block Device 
Request (Interrupt 21h, service 
44h, function ODh) DOS 
service, 667-669 
Get Address of InDOS Flag 
(Interrupt 21h, service 34h) 
DOS service, 635-636 


Get Allocation Strategy (Interrupt 
21h. service 58h. function OOh) 
DOS service. 68‘ 7 *688 
Get Boot Drive Code (Interrupt 
21h, service 33h, function 05h) 
DOS service, 634 
Get Clock Counter (Interrupt lAh. 

service 0) BIOS service, 565 
Get Communications Port Status 
(Interrupt 14h. service 3) BIOS 
service, 534-535 
Get Ctrl-Break Flag (Interrupt 
21h. service 33h, function OOh) 
DOS service, 633 

Get Current Drive (Interrupt 21h, 
service 19h) DOS service. 

609-610 

Get Current Video State 
(Interrupt lOh. service OFh) 

BIOS service. 498 
Get Day Count (Interrupt lAh, 
service OAh) BIOS service, 
571-572 

Get Default Disk Parameter Block 
(Interrupt 21h. service lFh) 

DOS service, 613-615 
Get Device Information 
(Interrupt 21h, service 44h 
function OOh) DOS service, 
652-654 

Get Directory Path (Interrupt 
21h, service 47h) DOS service, 
674-675 

Get Disk Free Space (Interrupt 
21h, service 36h) DOS service, 
637-638 

Get Disk Parameter Block 
(Interrupt 21h. service 32h) 
DOS service, 632-633 

Get Disk Transfer Area (Interrupt 
2ih, service 2Fh) DOS service. 


630 

Get DOS Version Number 
(Interrupt 21h, service 30h) 
DOS service, 630-631 
Get DOS Version Number 

(Interrupt 2lh, service 33. 

function 06h) DOS service. 635 
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Get Double-Byte Character Set 
(Interrupt 21h, service 65h. 
function CPh) DOS service, 
714-715 

Get Equipment Status (Interrupt 
llh) BIOS service, 505-506 
Get Extended BIOS Address 
(Interrupt 15h, service Clh) 
BIOS service. 551-552 
Get Extended Country 
Information (Interrupt 21h, 
service 65h, function Olh) DOS 
service, 707-709 
Get Extended Keyboard Status 
Flags (Interrupt 16h, service 
12h) BIOS service, 561 
Get Extended Keystroke 
(Interrupt 16h, service lOh) 
BIOS service, 560 
Get Extended-Error Information 
(Interrupt 21h, service 59h) 
DOS service. 691-695 
Get FAT (File Allocation Table) 
Information for Default Drive 
(Interrupt 21h, service lBh) 
DOS service, 611-612 
Get FAT Information for Drive 
(Interrupt 21h, service ICh) 
DOS service, 612-613 
Get File Size, Using FCB 
(Interrupt 21h, service 23h) 

DOS service, 617-618 
Get Filename Uppercase Table 
(Interrupt 21h, service 65h, 
function 04h) DOS service, 
711-712 

Get Floppy Disk Status (Interrupt 
13h, service 1) BIOS service, 
508-509 

Get High-Memory Link Status 
(Interrupt 21h. service 58h, 
function 02h) DOS service 
689-690 

Get Input Status (Interrupt 2lh, 
service 44h, function 06h) DOS 
service, 660 


Get Interrupt Vector (Interrupt 
21h. service 35h) DOS service, 
636-637 

Get Invalid Filename Character 
Table (Interrupt 21, service 
65h, function 05h) DOS 
service, 712-713 
Get Logical Device Map 
(Interrupt 21h, service 44h, 
function OEh) DOS service, 
669-670 

Get Machine Name (Interrupt 
21h, service 5Eh, function OOh) 
DOS service, 700-701 
Get Memory Size (Interrupt 12h) 
BIOS service, 507 
Get Output Status (Interrupt 21h, 
service 44h, function 07h) DOS 
service, 660-661 

Get Printer Setup (Interrupt 21h, 
service 5Eh, function 03h) DOS 
service, 702-703 

Get Printer Status (Interrupt 17h 
service 2) BIOS, 563-564 
Get Program Segment PreBx 
(PSP) Address (Interrupt 2lh 
service 62h) DOS service, 706 
Get PSP Address (Interrupt 2lh 
service 51h) DOS service, 685 
Get Redirection List Entry 
(Interrupt 21h, service 5Fh 
function 02h) DOS service ’ 
703-704 

Get Return Code of a Subprocess 
(Interrupt 21h, service 4Dh) 
DOS service, 681-682 
Get Sort Sequence Table 
(Interrupt 21h, service 65h 
function 06h) DOS service ’ 
713-714 ' 




- -r- Jtivice 

BIOS service, 549.551 

Get System Date (Interrupt 2 ll 

service 2Ah) DOS service <£ 

Get System Time (Intern. ' $ 2 

service 2Ch) DOS servi P * 21 
’ service, 62 
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Get Uppercase Table (Interrupt 
21h, service 65h, function 02h) 
DOS service, 710 • 

Get Verify Setting (Interrupt 21h, 
service 54h) DOS service. 

685-686 

Get/Set Country-Dependent 
Information (Interrupt 21h, 
servtce 38h) DOS service. 

638-642 

Get/Set File Attributes (Interrupt 
21h, service 43h) DOS service, 
651-652 

\ Get/Set File Date and Tinje 
(Interrupt 21h, service 5"h) 

DOS service, 687 
Gct/$et Global Code Page 
(Interrupt 2Ih, service 66h) 

DOS service. 718 
global 

code page, 718 
control, directives. 873 
definitions, MultiUse, 942-943 
descriptor table (GDT) register. 25 
GLOBAL: MultiUse Global 
Definition directive. 942-943 
Go command, 175-176, 197 
GOSUB command, 52 
GOTO: Transfer Control 
directive, 943 
graphics 
arrays, 377 

characters, ASCII. 395 
routines, text-based, 394-400 
GROUP: Specify Common 
Segment Grouping directive, 
944 

grouping segments, common, 944 
GS register, loading. 825 
GW-BASIC, 266-26 
string length, 275 


H 


Handle Local/Remote 
Determination (Interrupt 2Ih, 
service 44h, function OAh) DOS 
service. 664-665 
handlers 

addresses, critical-error, 723 
interrupt, 419 
handles 
count, 719 

duplicating, forced, 673-674 
Ale. duplicating, 673 
querying, 671 
hardware 

debuggers, 167-168 
environment, 13 
interrupts. 26. 384 
pons, 413-445 
heads, 451 
parking. 529 
help. 119. 149 

displaying information, 95-97 
extended, 124 
help option. 124 
Hercules Graphic Adapter 
(HGA). 372 
hexadecimal 
addition, 176 
calculator, 176 
notation, 17 
subtraction, 176 
Hexadecimal Arithmetic 
command, 176 
hexadecimals, 170 
HGA (Hercules Graphic Adapter), 
372 

high memory, 14 
high-level language debuggers, 
built-in, 168 

HLT. Halt instruction, 804 
horizontal retrace condition 
(HRC), 382-384 
hypen (-) delimiter, 95 


halt, 804 - 

Handle Generic Code-Page /I option, 124 

Switching (Interrupt 21 h. L'O 

service 44h. function OCh) DOS address, 413 

service. 666-66’' 


* 
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pons. 414 

addresses, 416-417 
map, 416-418 
ideal assembly mode, 944 
ideal mode, 69 

ideal mode (Turbo Assembler), 67 
IDEAL: Enter Ideal Assembly 
Mode directive, 944 
identifiers 

case sensitivity, 152 
defining, 121,* 150-151 
user, 120 

IDIV: Integer Divide instruction, 
805 

IDT register, loading, 825 
.IF: Conditional Program 
Execution directive, 944-945 
IF: Conditional Assembly 
directive, 9*6 

IF1: Assemble if on Assembler 
Pass 1 directive. 946-947 
IF2: Assemble if on Assembler 
Pass 2 directive, 947 
IFB: Assemble if Blank directive. 
947-948 

IFDfcP: Assemble if Defined 
directive 948 

1FDIF Assemble If Strings Are 
Different directive, 949 
IFDIFI: Assemble if Strings Are 
Different (Case Insensitive) 
directive, 949-950 
IFE: Assemble if False directive, 
950 

IFIDN: Assemble if Strings Are 
Identical directive, 950-951 
IFIDNI: Assemble if Strings Are 
Identical (Case Insensitive) 
directive, 951-952 
IFNB: Assemble if Argument Is 
Not Blank directive, 952 
IFNDEF: Assemble if Not Defined 
directive, 952-953 
Ignore Extended Dictionary 
option, 100 

immediate addressing, 45 
IML'L: Integer Multiply 
instruction. 805-806 


IN statement, 414-416 
in-circuit devices, 167 
in-circuit emulators, 167 
IN: Input from Port instruction, 
806 

INC: Increment instruction, 
806-807 

%1NCL: Enable Listing of 
INCLUDE Files directive, 953 
Include Cross-References in the 
Listing File option, 149-150 
INCLUDE environment variable, 
128 

INCLUDE files, 125, 151 
listing. 953 
disabling. 970 
path, 124 

Include Global Symbol Table in 
List File option. 101 
Include Line Numbers in List File 
option, 101 

Include Line Numbers in Object 
File option, 157 
INCLUDE. Insert Source Code 
from .Another File directive 
053-^54 

INCLLDEL1B: Specify Library for 
Linker To Use dire. 954 
increment, 806-807 
incrementing pointers, stack, 783 
index register, 4~ 
indirect addressing, 46-48 
inference rule, 209-210 
Initialize All Segments option, 100 
Initialize Communications Port 
(Interrupt 14h, service 0) BIOS 
service, 530-532 
Initialize Fixed Disk Table 
(Interrupt 13h, service 9) BIOS 
service, 517-518 
Initialize Printer (Interrupt 17h 
service 1) BIOS service, 563 
initializing 

ports, communications 
530-536 
printers, 563 
processors, 783-784, 79 j 
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Inline 

ASM coding. 314 
coding. 315 
routines, 28-» 
statements. 289, 314 
inline!) statement, 283 
input 

auxiliary. 589-590 
buffered, 594 
character, with echo. 588 
ports, 806 

string byte, 807 
string doubleword, 808 
string word, 808 
strings, ports. 807 
Input command, 176 
INS; Input String from Port 
instruction, 807 

INSB: Input String Byte from Port 
instruction, 807 

INSD: Input String Doubleword 
from Port instruction, 808 
INSTR: Return a Position of One 
String in Another directive, 
954-955 

instruction pointer (IP) register, 

17, 24, 257 
instruction set, 32 

arithmetic instructions, 33 
bit-manipulation instructions, 

34 

control transfer instructions, 

35 

data-transfer instructions, 33 
flag- and processor-control 
instructions, 36 
string-manipulation 
instructions, 34 
instructions 

AAA: ASCII Adjust for Addition, 
758 

AAD: ASCII Adjust for Division, 
758-759 

AAM-. ASCII Adjust for 
Multiplication. 759 
AAS. ASCII Adjust for 
Subtraction, 759 
ADC. Add with Carry, 760 


ADD Add. 760 
additional. 8“1 
AND Logical AND on Bits. 

760-^61 
arithmetic, 732 
ARPL Adjust RPL Field of 
Selector, 761 

bit-manipulation, 733*734 
block, repeating. 940-941, 
955-956. 997-998, 1024 
BOUND Check Array Index 
against Bounds. 761-762 
BSF. Bit Scan Forward, 762 
BSR Bit Scan Reverse, 762 
BSWAP: Sw-ap 32-Bit Byte 
Order, 763 
BT Bit Test. 763 
BTC: Bit Test and 
Complement, 763*764 
BTR: Bit Test and Reset, 764 
BTS: Bit Test and Set, 764 
CALL Perform Subroutine, 765 
CBW: Convert Byte to Word, 

765 

CDQ; Convert Doubleword to 
Quadw’ord. 766 
CLC: Clear Cany Flag, 766 
CLD. Clear Direction Flag, 766 
CU: Clear Interrupt Flag, 767 
CLTS: Clear Task-Switched 
Flag, 767 

CMC: Complement Carry Flag, 

767 

CMP; Compare, 768 
CMPSB: Compare Strings, 
Byte-for-Byte, 768 
CMPSD: Compare Strings, 
Doubleword-for- 
Doubleword. 768*769 
CMPSW: Compare Strings. 

Word-for-word, 769 
CMPXCHG. Compare and 
Exchange. 769-770 
control-transfer, 24, 734 
CWD. Convert Word to 
Doubleword. 770 
CWDE Convert Word to 
Extended Doubleword, 770 


Scanned with CamScanner 




Using Assembly language, 3rd Edition 


DAA: Decimal Adjust for 
Addition. 771 
DAS: Decimal Adjust for 
Subtraction, 771 
Data-Transfer, 731 
DEC: Decrement, 771-772 
DIV: Divide, 772 
ENTER: Make Stack Frame for 
Procedure Parameters, 
772-773 

ESC: Escape, 773 
extended, 871 
F2XML 2M, 773*774 
FAJBS: Absolute Value, 774 
FADD: Add Real, 774 
FADDP: Add Real and POP, 
774-775 

FBLD: BCD Load, 775 
FBSTP: BCD Store and POP, 
775 

FCHS: Change Sign, 775*776 
FCLEX: Clear Exceptions with 
WAIT, 776 

FCOM: Compare Real, 776 
FCOMP: Compare Real and 
POP, 777 

FCOMPP: Compare Real and 
POP Twice, 777 
FCOS; Cosine, 777 
FDECSTP: De cr e men t Stack 
Pointer, 778 

FDIS1: Disable Interrupts with 
WAIT, 778 

FDIV: Divide Real, 778 
FDIVP: Divide Real and POP, 
779 

FDIVR: Divide Real Reversed, 
779 

FDIVRP: Divide Real Reversed 
and POP, 779*780 
FEN1. Enable Interrupts with 
WAIT, 780 

FFREE: Free Register, 780 
HADD Integer Add, 780-781 
FICOM . Integer Compare, 781 
FI COMP: Integer Compare and 
POP. 781 


FID1V: Integer Divide. 782 
FID1VR: Integer Divide 
Reversed. 782 

FILD: Integer Load, 782-783 
FIML'L: Integer Multiply, 783 
FINCSTP: Increment Stack 
Pointer, 783 

FINIT: Initialize Processor with 
WAIT, 783*784 
FIST: Integer Store, 784 
FISTP: Integer Store and POP, 
784 

FISUB: Integer Subtract, 
784-785 

FISUBR: Integer Subtract 
Reversed, 785 
flag, 24 

flag- and processor-control, 735 
FLD: Load Real, 785 
FLD1: Load 1.0, 786 
FLDCW: Load Control Word 
786 

FLDENV; Load Environment, 


FLDL2T: Load lot 10, 787 
FLDLG2: Load log 2 787 
FLDLN2: Load loc 2 788 
FLDPI: Load n, 788 
FLDZ: Load 0.0, 788 
FMUL: Multiply Real 780 

FN 78S C 90 C1ClrEXC ' PU ° m ' 
FNDISl: Disable Internjpts 7 QO 
FNENI : Enable Im e ™ p P “' ™ 

™ , nj ^ e Processor,^ 0 

FNSTCW:S,o re CoAS,Vord. 

fnsten* Slore Environment 
FN 7 S 92 S 7* j S '° r ' $UtU5 *Ord. 
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FPATAN: Partial Arctangent, 
793-794 

FPREM: Partial Remainder, 

793- 794 

FPREM 1: Partial Remainder, 

IEEE version, 794 
FPTAN: Partial Tangent, 794 
FRNDINT: Round to Integer, 

794- 795 

FRSTOR: Restore State, 795 
FSAVE: Save State with WAIT, 

795 

FSCALE: Scale, 796 
FSETPM: Set Protected Mode, 

796 

FSIN: Sine, 796 
FSINCOS: Sine and Cosine, 797 
FSQRT: Square Root, 797 
FST: Store Real, 797 
FSTCW: Store Control Word 
with WAIT, 798 
FSTENV: Store Environment 
with WAIT, 798 
FSTP: Store Real and POP, 798 
FSTSW: Store Status Word with 
WAIT, 799 

FSUB: Subtract Real, 799 
FSUBP. Subtract Real and POP, 
799-800 

FSUBR: Subtract Real 
Reversed, 800 
FSUBRP: Subtract Real 
Reversed and POP, 800 
FTST: Test, 800-801 
FUCOM: Unordered Compare, 
• 801 

FUCOMP: Unordered 
Compare and POP, 801 
FUCOMPP: Unordered 
Compare and POP Twice, 
802 

FWAIT: CPU Wait, 802 
FXAM: Examine, 802-803 
FXCH: Exchange Registers, 
803 

FXTRACT: Extract Exponent 
and Significand, 803 
FYL2X: Y'logpC, 803-804 


FYL2XP1: Y*logj(X+l), 804 
MLT: Halt, 804 
IDIV: Integer Divide, 805 
IMUL: Integer Multiply, 

805-806 

IN: Input from Port, 806 
INC: Increment, 806-807 
INS: Input String from Port, 

807 

INSB: Input String Byte from 
Port, 807 

INSD: Input String 
Doubleword from Port, 808 
INSW: Input String Word from 
Port, 808 

INT: Software Interrupt, 

808- 809 
Intel, 735-745 

INTO: Interrupt on Overflow, 

809 

1NVD: Invalidate Data Cache, 

809- 810 

INVLPG: Invalidate TLB Entry 
if Present, 810 . 

I RET: Return from Interrupt, 

810 

JA: Jump if Above, 810-811 
JAE: Jump if Above or Equal, 
811 

JB: Jump if Below, 811 
JBE: Jump if Below or Equal, 
811-812 

JC: Jump on Carry, 812 
JCXZ: Jump if CX*0,812 
JE: Jump if Equal, 812-813 
JECXZ: Jump if ECX-0,813 
JG: Jump If Greater, 813 
JGE: Jump if Greaser or Equal, 
814 

JL: Jump if Less, 814 
JLE: Jump if Less or Equal, 814 
JMP: Jump, 815 
JNA Jump if Not Above, 815 
JNAE: Jump if Not Above or 
Equal, 815 

JNB: Jump if Not Below, 816 
JNBE: Jump if Not Below or 
Equal, 816 
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JNC:Jumpon No Carr,. 816 
JNE: Jump if Not Equal. 817 
JNG: Jump if Not Greater. 817 
JNGE: Jump if Not Greater or 
Equal. 817 

JNL: Jump if Not Less, 818 
JNLE: Jump if Not Less or 
Equal, 818 

JNG: Jump on No Overflow, 

818 ^ 

JNP: jump on No Parity. 819 
JNS: Jump on Not Sign, 819 
JNZ: Jump on Not Zero, 819 
JO: Jump on Overflow, 820 
JP: Jump on Parity, 820 
JPE: Jump on Parity Even, 820 
JPO: Jump on Parity Odd, 821 
JS: Jump on Sign. 821 
JZ: Jump on Zero, 621 
LAHF: Load AH Register with 
Flags, 822 

LAR: Load Access-Rights Byte, 
822 

LDS: Load DS Register, 822- 
- v 823 

LEA: Load Effective Address, 

. 823 

LEAVE: High-Level Procedure 
Exit, 823 

LES: U)ad ES Register, 823-824 
LFS: Load FS Register, 824 
LGDT: Load GDT Register, 824 
LGS: Load GS Register, 

824-825 

UDT: Load IDT Register, 825 
LLDT: load LDT Register. 825 
LMSW: Load Machine Status 
Word, 826 

LOCK: Lock Bus, 826 
LODSB: Load a Byte from 
String into AL, 826 
LODSD: Load a Doubleword 
from String into EAX, 827 
LODSW: Load a Word from 
String into AX, 827 
LOOP: Loop, 827-828 
LOOPE: Loop While Equal. 828 


LOOPNE Loop While Not 
Equal. 828 

LOOPNZ: Loop While Not 
Zero. 829 

LOOPZ: Loop While Zero, 829 
LSL. Load Segment Limit, 
829-830 

LSS: Load SS Register. 830 
LTR: Load Task Register, 830 
MOV, 72 
MOV; Move, 831 
MOVSB: Move String. 

Byie-by-Byte, 831 
MOVSD; Move String, 
Doubleword-by- 
Doubleword, 832 
MOVSW: Move Slrinp 
Word-by-Word, 832 
MOVSX: Move with Sign 
Extended, 832-833 
MOVZX: Move with Zero 
Extended, 833 
MUL: Multiply, 833-834 
NEG: Negate, 834 
NOP: No Operation, 834 
NOT: Logical NOT, 835 
numeric 

comparison, 734 
constant, 733 
transcendental, 733 
OR: Logical OR, 835 
OUT: Output to Port, 835-836 
OUTS. Output String to Port 
836 

OUTSB: Output String Byte to 
Port. 836-837 
OUTSD; Output String 
Doubleword to Port, 837 
OUTSW: Output String Word 
to Port, 837 

POP: Remove Data from Stack. 
837-838 

POPA: POP All General 
Registers, 838 
POPAD: POP All General 
Doubleword Registers, 838 
POPF: Remove Flags from 
Suck, 839 
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POPFD: Remove Emended 
Flags from Stack, 839 
processor control. 24 
processor* and flag-control. 

735 

PUSH: Place Data on Stack, 

839- 840 

PUSHA: Push All General 
Registers, 840 
PUSHAD: Push All General 
Doubleword Registers. 840 
PUSHF: Place Flags on Stack, 

840- 841 

PUSHFD-. Place Extended Flags 
on Stack. 841 
RCL: Rotate Left through 
Carry , 841 

RCR: Rotate Right through 
Carry, 8-*2 
REP: Repeat. 842 
REPE: Repeat if Equal. 8^2-843 
REPNE; Repeat if Not Equal, 

843 

REPNZ: Repeat if Not Zero. 

843 

REPZ: Repeat if Zero. 844 
RET, 72 

RET: Return from Subroutine. 

844 ^ 

ROL. Rotate Left, 844-845 

ROR: Rotate Right, 845 
SAHF: Store AH into Flags 
Register, 845 

SAL: Arithmetic Shift Left, 846 
SAR. Arithmetic Shift Right, 

846 

SBB: Subtract with Carry, 
846-847 

SCASB: Scan String for Byte, 

847 

SCASD: Scan String tor 
Doubleword. 847*848 
SCASW: Scan String for * ord, 

848 

SETA: Set Byte if Above, 
848-849 

SETAE: Set Byte if Above or 
Equal. 8-i9 


SETB; Set Byte if Below, 849 
SETBE. Set Byte if Below or 
Equal, 849-850 
SETC. Set Byte on Carry. 850 
SETE Set Byte if Equal v 850 
SETG: Set Byte if Greater. 851 
SETGE: Set Byte if Greater or 
Equal. 851-852 

SETL: Set Byte if Less. 851-852 
SETLE: Set Byte if Less or 
Equal, 852 

SETNA; Set Byte if Not Above, 

852 

SETNAE: Set Byte if Not Above 
or Equal, 852-853 
SETNB. Set Byte if Not Below, 

853 

SETNBE. Set Byte if Not Below 
or Equal, 853 

SETNC: Set Byte on No Carry. 

854 , , 

SETNE: Set Byte if Not Equal. 

854 

SETNG- Set Byte if Not 
Greater. 85-*-855 
SETNGE. Set Byte if Not 
Greater or Equal. 855 
SETNL: bet Byte if Not Less. 

855 

SETNLE: Set Byte if Not Less or 
Equal. 856 

SETNO: Set Byte on No 
Overflow, 856 

SETNP: Set Byte on No Parity. 
856-857 

SETNS: Set Byte on Not Sign. 

85 ? 

SETNZ: Set Byte if Not Zero, 

857 _ 

SETO: Set Byte on Overflow, 
857-858 

SETP; Set Byte on Parity, 
SETPE; Set Byte on Parity 
Even. 858 

SETPO: Set Byte/>n Parity 
Odd 859 

SETS: Sei Byte on Sign, es* 
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SETZ: Set Byte if Zero, 859*860 
SGDT: Store GDT Register, 860 
SHL: Shift Left, 860 
SHLD: Shift Left, Double 
Precision, 861 
SHK Shift Right. 861 
SHRD: Shift Right. Double 
Precision, 861*862 
SIDT: Store Interrupt 
Descriptor Table Register, 862 
SLDT: Store Local Descriptor 
Table Register, 862 
SMSW: Store Machine Status 
Word, 863 

STC: Set Carry Flag, 863 
STD: Set Direction Flag, 863 
ST1: Set Interrupt Flag, 864 
STOSB: Store Byte in AL at 
String, 864 

STOSD: Store Doubleword in 
' EAX at String, 864 
STOSW: Store Word in AX at 
String, 865 

STR: Store Task Register, 865 
string-manipulation, 734 
SUB: Subtract, 865*866 
TEST: Test Bits, 866 
VERR: Verify a Segment for 
Reading, 866-867 
VERW: Verify a Segment for 
Writing, 867 
WAIT: Wait, 867 
WBINVD: Invalidate Cache and 
Write Back, 867-868 
XADD: Exchange and Add to 
Memory, 868 
XCHG: Exchange, 868 
* XLATuTranslate, 869 

XOR: Logical Excluslve-Or, 869 
1NSW: Input String Word from 
Port instruction, 808 
INT: Software Interrupt 
instruction, 808-809 
integers 

adding. 780-781 
comparing, 781 
dividing. 782 
flags, 273 


loading, 782-783 
multiplying, 783 
rounding, 794-795 
storing, 784 
subtracting, 784-785 
variables. 273 
x-y coordinates, 386 
Intel instructions, 735*745 
interface board, MDA, 372 
interfacing 

C with C++, 307*325 
Clipper, 341*353 
dBASE III+, 327*339 
dBASE IV, 336 
FoxPro, 327*339 
languages, assembly, 265 
. Pascal, 283*292 
pointing device, 552*553 
subroutines 

returned values, 349*350 
variable passing, 315*318, 
346-348 

international addresses 
calculations, 309 
interpreters, 328 
interpretive BASIC, 266, 275 
interpretive language, 265 
interrupt descriptor table (IDT) 
register. 25 

interrupt-identification register, 
442*443 

'’interrupting descriptor cable 
.register, 862 
interrupts, 26 

attributes, 284*285 
breakpoint, 194 
character, writing, 492-493 
controller, 418-419 
debugging, 194 
disabling, 778-790 
enabling, 780, 790 
flag 

clearing. 767 
setting, 864 
handler, 419 
hardware, 26, 384 
multiplex, 726 
overflow, 809 
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returning. 810 
software, 26, 808-809 

invoking subroutines, 4^3 
vector. 620 

INTO: Interrupt on Overflow 
instruction, 809 
INVD: Invalidate Data Cache 
instruction. 809-810 
invisible characters, 387 
INVLPG. Invalidate TLB Entry if 
Present instruction, 810 
INVOKE: Execute a Procedure 
directive, 955 
invoking subroutines. 255 
IOPL flag, 361 
IP (instruction pointer). 17 
IRET: Return from Interrupt 
instruction, 810 
1RP directive. 81 
IRP: Repeat a Block of 
Instructions, Using an 
Argument List directive. 955 
IRPC directive, 82 
IRPC: Repeat a Block of 
Instructions, Using a String 
directive. 956 

Issue Fixup Warnings option, 106 


_J_ 

JA: Jump if Above instruction. 
810-811 

JAE: Jump if Above or Equal 
instruction, 811 

Jam Directive into Effect option, 
151 

JB: Jump if Below instruction. 811 

JBE: Jump if Below or Equal 
Instruction, 811-812 

JC: Jump on Carry instruction, 

812 

JCXZ: Jump if CX=0 instruction, 
812 

JE: Jump if Equal Instruction, 
812-813 

JECXZ: Jump If ECX=0 
instruction, 813 

JG: Jump if Greater instruction. 813 


JGE: Jump if Greater or Equal 
instruction, 814 

JL: Jump if Less instruction, 814 
JLE: Jump if Less or Equal 
instruction, 814 
JMP: Jump instruction, 815 
JNA: Jump if Not Above 
instruction, 815 

JNAE: Jump if Not Above or Equal 
instruction. 815 
JNB: Jump if Not Below 
instruction, 816 
JNBE: Jump if Not Below or 
Equal instruction, 816 
JNC: Jump on No Carry 
instruction, 816 
JNE: Jump if Not Equal 
Instruction, 817 
JNG: Jump if Not Greater 
instruction, 817 
JNGE: Jump if Not Greater or 
Equal instruction, 817 
JNL: Jump if Not Less instruction, 
818 

JNLE: Jump if Not Less or Equal 
instruction. 818 
JNO: Jump on No Overflow 
instruction, 818 
JNP: Jump on No Parity 
instruction, 819 
JNS: Jump on Not Sign 
instruction, 819 
JNZ: Jump on Not Zero 
Instruction, 819 
JO: Jump on Overflow 
instruction. 820 
joystick, 545 

Joystick Support (taterropt 15h, 
service 84h) BIOS, 544-545 
JP: Jump on Parity instruction, 820 
JPE: Jump on Parity Even 
Instruction, 820 
JPO: Jump on Parity Odd 
instruction. 821 

JS: Jump on Sign instruction, 821 
JUMPS: Enable Jump Stretching 
directive, 956 

JZ: Jump on Z*jro instruction, 821 
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K 

Key-Click Control (Interrupt 16h. 

service 04h) BIOS service. 559 
Keyboard Intercept Hook 
(Interrupt 15h. service -iFh) 
BIOS service. 5-i 1 
keyboards 

buffer, writing to. 559-560 
characters, reading, 554-555 
codes 

BIOS. 103M036 
controller. 1039-1042 
controlling. 421. 424~*28 
extended, status, 561 
intercept hook. 541 
interrupt vector, 428 
shift status, 557-558 
starus. 556-557 
keystrokes, extended, 560 


_L_ 

label fields. .ASM files. 72 
LABEL Define a Symbol directive. 

956-95 

labels 

code, directives. 87** 
commands, 31 

converting to uppercase. 153 
defining in another module. 

935-939 

values 

assigning. 8"8 
constant. 918 

LJfF Load .AH Register with 
“lags instruction. 822 
.lALL; Enable Listing of .All Macro 
Expansions directive. 957 
anguages 
assembly 

expanding. 871 
interfacing. 265 
mnemonics. 1 7 2 
.•ompiled. 265 
.merpretive. 265 
machine 

instructions. 1“2 


translated from source 
code. 265 
specify ing. 309 
xBase. 32“ 

LAR Load Access-Rights Byte 
instruction. 822 
LARGEST.ACK: Specify- 32-B*t 
Stack Pointer directive. 95"-958 
last-in, first-out queue. 21 
LDS: Load DS Register 
instruction, 822-823 
LDT register, loading. 825 
LEa Load Effective Address 
instruction, 823 

LEANT: High-Level Procedure Exit 
instruction. 823 

LES Load ES Register instruction. 
823-824 

.LFCOND. List .All Conditional 
Statements directive. 958 
LFSr Load FS Register instruction, 
824 

LGDT-. Load GDT Register 
instruction, 82-* 

LGS: Load GS Register 
instruction, 82-1-825 
I IB 238-2-*3 
operations, 2-*l 
options 239 
libraries 

advantages. 237-238 
C. 137 

creating, 2-*0-2-*-» 
default, 102 

environment variables. 13" 
files. 13"\ 2-*0-241 
linker, specify ing. 954 
linking. 2 -h- 2-*6 
maintaining. 2-»8 
managing. 250-251 
modify ing. 248-249 
operations, 241 
programs, maintenance. 238-239 
Quick Library QLB file. 2“9 
response files 246-248 
routines, run-time, 342 
updating subroutines. 250 
L1DT: Load IDT Register 
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instruction. 825 
light pen status. 482 
line numbers 

information, 129 
object files, 15* 7 
line-control register, 443 
line-printer interface ports. 439 
line-status register. 444 
lines 

command, 208 
dependency. 209 
errors, displaying. 132 
scan, 479 
source, 157 
LINK. 109 
command, 95 
command line. 138-139 
linker. 8 7 

linking BIN files, 337 
LINK.EXE file. 137 
linkage editors. 86 
linkers, 31. 85-86, 109, 136 
alternate, 120 
batch mode, 97 
debugging, source-level, 86 
files, creating. 88-89 
library, specifying, 954 
LINK. 87 
options, 92-95 
• listing. 100 
passing. 125 
TUNK, 87-88 
linking, 57 

BIN files, 336-337 
files. 136-137 
libraries, 244-246 
object-code files, 137 
subroutines. 237 
%L1NUM: Set Listing-File Line- 
Number Field Width directive, 
958 

.L1STALL: Include Everything in 
Listing File directive. 959 
%L!ST: Enable Source-Code 
Listing directive. 958-959 
LIST: Enable Source-Code Listing 
directive. 959 
L1STIF directive. 12 7 


L1ST1F List All Conditional 
Statements directive, 960 
List False Conditional Statements 
option, 156 

list files. 90-91. 137, 242 

List Linker Options option, 100 

listing 

conditional statements. 893 
controls 

restoring. 985-986 
saving temporarily, 991 
INCLUDE files, 953 
disabling, 970 
macros 

code generating. 960. 1026 
disabling. 971 
expansions. 957-962 
source code. 959 
disabling, 970-971 
statements conditional. 
958-960, 968-971. 1003 
listing files 

advancing. 967 
address field width, 984 
creating, 152 
cross-references, 149-150 
depth field width. 901 
expanded, creating, 152 
line number width. 958 
listing control directives, 897 
LST. 73-78 

object code field width. 887 
page control. 983*984 
page dimensions, 984 
source field width, 1014 
subtitles, specifying, 
1009-1010 
symbol table. 973 
tab stops width. 1012 
tables 

excluding, 153 
symbol, 1011 
titles. 1015 

word-wrap, controlling, 9. 4, 
1016 
listings 

control, directives, 8~o 
first-pass. 125 
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generating. 125 

length. 126 

line width. 126 

macro, 998 

page depth. 126 

source code. 1026 

statements, conditional. 1015 

subtitles. 126 

tables, symbol. 126 

titles. 127 

width, 126 

.USTMACRO: List Only Macros that 
Generate Code directive, 960 
•LISTMACROALL: Enable Listing 
of All Macro Expansions 
directive. 960 
LLDT: Load LDT Register 
instruction. 825 
LMSW. Load Machine Status 
Word instruction. 826 
Load command, 177 
Load Overlay (Interrupt 21h. 
service 4Bh, function 03h) DOS 
service, 679 

Load Program (Interrupt 21h, 
service 4Bh. function OOh) DOS 
service, 677-678 
Load Program in High Memory 
option, 100 

LOAD xBase command, 327 
loading 

control word, 786 
DEBUG. 187-190 
disk sectors. 177 
files 

BIN, 332 
to memory. 177 
integers. 782-783 
overlays, 679 

Programmer’s Workbench, 112 
programs, 677-678 
segments, limits. 829*830 
local 

menu, 232 
symbols 

disabling, 972 
enabling. 961 
variables, defining, 961 


local descriptor table (LDT) 
register, 25 
LOCAL directive. 81 
LOCAL: Define Local Variables 
directive, 961 

LOCALS: Enable Local Symbols 
directive, 961 
LOCATE statement. 270 
location counter 
adjusting, 884-885 
even address, 933-934 
LOCK: Lock Bus instruction. 826 
locking bus. 826 
LODSB: Load a Byte from String 
into AL instruction. 826 
LODSD: Load a Doubleword 
from String into EAX 
instruction. 827 

LODSW: Load a Word from String 
into AX instruction. 827 
Logical Device Local/Remote 
Determination (Interrupt 2lh, 
service 44h, function 09h) DOS 
service, 662-663 
lookahead queues. 415 
LOOP: Loop instruction, 827-828 
LOOPE: Loop While Equal 
instruction, 828 
loc t . j9 

LOOPNE. Loop While Not Equal 
instruction. 828 
LOOPN2: Loop While Not Zero 
instruction, 829 
loops, 827-829 
REPEAT 

ending. 1018-1020 
modifying execution, 894-895 
terminating. 887-888 
•WHILE 

ending. 916-917 
modifying execution. 

894-895 

terminating 887-888 
controlled, beginning, 

996-997. 1022-1024 
ending. 915 
operators. 8.P-888 
'X'HILE. \X END. 270 
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LOOPZ: Loop While Zero 
instruction. 829 
LSL: Load Segment Limit 
instruction. 829*830 
LSS: Load SS Register instruction, 
830 

LST listing file, 73-78 
LTR: Load Task Register 
instruction. 830 


__M_ 

96MACS: Enable Listing of All 
Macro Expansions directive, 
962 

machine code. 30, 342 
machine language 
instructions, 17. 172 
statements, executing, 175 
machine language mode. 185 
matching status word (MSW^ 
register, 25 

Macro Assembler, see MA5M ' 
MACRO: Define the Stan of a 
Macro directive, 962 
macros. 80-83 

beginning, defining. 962 
built-in, 211-212, 218-220 
code generating, listing, 960, 
972, 1026 
definitions, 211 
deleting, 990 

environment variables, 213 
directives, 81, 875 
ending, 915 
excessive use, 213 
exiting immediatly, 935 
expansions, listing, 957-962 
formal parameters, 81 
listings, disabling, 971, 998 
removing from memory, 82 
text, defining, 1014 
user-defined, 213 
main memory, 14 
MAKE, 207-209 
file, 317 

Borland. 217-220 


dependency files, 208 
description blocks, 208 
menu. 115, 31 7 
options, 217 

Make All Names Uppercase 
option, 153 

Make Case of Global SvmboLs 
Significant option, 153 
Make Case of Names Significant 
option, 152 

managing libraries, 250-251 
Map Expanded Memory 
command, 182 
MAP file extension, 137 
MAP files. 90-91 
map listing file, 122 
mapping memory, expanded. 182 
maps 

LO port, 416--* 18 
memorv. 15 
MASM. 109 

4.0, compatibility. 963 
5.1 

compatibility. 963, 972 
exit codes. 134 
options, compatibility. 
130-131 
6.0, 112-116 
directives, 37-38 
assembler, 6 7 -68 
command line, 115 
compatibility to Turbo 
Assembler. 70-71 
quirks, handling, 991 
MASM: Enable MASM 4.0 
Compatibility directive, 963 
MASM51: Enable MASM 5.1 
Compatibility directive, 963 
math emulator. 123 
MCGA (Multi-Color Graphics 
Array), 376-377 
MDA (Monochrome Display 
Adapter), 369-372 
MEM command, 18*19 
memory, 14. 17-20 
addressable, 16 
addresses. 16-17, 328 
register. 15 
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allocating. 98. 131. 2' 7 3. 

675 - 6^6 
expanded. 181 
freeing. 6" T 6 
blocks 

comparing, 173 
filling, l^S 
moving. 177 
searching. 179-180 
data storage. 4044 
expanded. 1-* 

deallocating. 182 
mapping. 182 
extended. 14 

moving blocks to'from, 
547-348 
sue. 5-*8 

files, loading. 177 
high, 14 
locations 
CGA. 3"*3 
contents. 17., l”-* 

EGA. 3’6 

MDA display data. 3 7 0-3“l 
macros, removing, 82 
main, 14 
management. 15 
segments. 308 
managers. 14 
map. 15 

models, 308-309 
compact. 309 
definitions, 309 
huge. 309 
large, 309 
medium. 308 
small. 308 
specifying, 964-966 
r ! nv, 309 

reserved, poking subroutines. 
273 

screen, character position, 367 

segments, 17-18, 49 

sue, 507 

stacks. 20-21 

storing, routines, 266 

vzl aes renaming. 261 


video. 36‘ 7 -411 
virtual 

enabling. 127 
files. 92 

memory managment unit (MMU), 
729 

memory-mapped display, 367 
memvar, 333 
menus 
local. 232 
MAKE. 115. 317 
messages 

copyright. 125 
errors, 138 

warning. 128, 156, 279 
method tables, defining, 
1011-1012 
microprocessors, 13 
minus sign (-) operation code. 

239 

miscellaneous directives. 8 7 7 
ML 

batch files. 132-134 
error codes, 134-135 
program, 116 

MMU (memory managment unit), 
729 

mnemonics 

assembly language. 172 

classes, 32 

string-manipulation. 368 
.MODEL: Specify Memory Model 
directive, 963-966 
MODEL: Specify Memory Model 
directive. 966 
models 

memory, 308-309 
compact, 309 
definitions, 309 
huge, 309 
large, 309 
medium, 308 
small, 308 
specifying. 964-966 
programming, 728-730 
modem-control register, 444 
modem-status register, 445 
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modes 

assembly, ideal. 944 
batch. 9” 
ideal. 6'-69 

machine language. 185 
protected. 25. 548-5-49. 728. 

796 

real. 25. 728 
verbose. 132 
video, setting. 4'7-4~8 
modifiers, commands. 211. 220 
modifying libraries. 248-2-49 
module-definition file. 138 
modules, names. 96' 
monochrome adapter. 432-433 
Monochrome Displav Adapter 
(MDA), 369-3 7 2 
mouse 185 

MOUSE.SYS device driver, 2“ 
MOV instruction. 72 
MOV statement. 414 
MOV: Move instruction. 831 
Move Block to from Extended 
Memory (Interrupt 15h. service 
87h) BIOS service, 54 T -548 
Move command. I" 

Move File Pointer (Interrupt 21 h. 
service 42h) DOS service. 
650-651 
moving 

blocKS, memon'. 1 
cursor. 185 
file pointer. 650-651 
strings 

byte-bv-byte. 831 
doubleword-by- 
doubleword. 832 
word-by-word. 832 
MOVSB: Move String. Byte-by- 
Byte instruction. 831 
MOVSD: Move String. 
Doubleword-by-Doubleword 
instruction. 832 

MOVSW: Move String, VX’ord-by¬ 
word instruction. 832 
MOVSX: Move with Sign 
Extended instruction 852-833 


MOVZX: Move with Zero 
Extended instruction. 833 
MSFLOAT: Specify Microsoft 
Floating-Point Format directive. 
966 

Ml'L: Multiply instruction. 
833-834 

MULTERRS: Enable Multiple 
Error Reporting directive, 966 
Multi-Color Graphics Array 
(MCGA), 3 t 6-377 
multiline comments, 72 
Multiplex Interrupt (Interrupt 
2Fh) DOS service, 726 
multiplex interrupts. 726 
multiplication. 833-834 
multiplying integers, 783 
Multil’se external definitions, 937 
Multil’se global definition. 
942-943 


_N_ 

Name command. 177 
NAME: Define the Module Name 
directive. 9CT 
names 

convening to uppercase. 153 
file, parsing. 624-625 
module, defining. 967 
naming 

code segments. 310 
data segments. 310 
NEAR pointers. 311 
NEAR procedure. 52. 257 
near returns. 172 
NEG: Negate instruction. 834 
%NEVCPAGE: Advance Listing File 
to New Page directive. 967 
NMAKE 

command-line options. 215 
directives. 213-215 
invoking. 215 
NMAKE utiliry, 209 
NMI (nonmaskable interrupt), 

168 
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N08’ Disable Numeric 
Coprocessor Programming 
directive, 967-968 
%NOCONDS. List True 
Conditional Statements 
directive. 968 
%.NOCR£F: Disable Cross- 
Referencing directive, 968 
.NOCR£F: Disable Cross- 
Referencing directive, 968-969 
%NOCTLS: Exclude Listing- 
Control Directives from the 
Listing File directive, 969 
NOEMUL: Don’t Use Floating- 
Point Emulator directive. 969 
%NOINCL: Disable Listing of 
INCLUDE Files directive. 970 
NOJUMPS: Disable Jump 
Stretching directive, 970 
%NOLIST: Disable Source-Code 
Listing directive, 9" f 0 
.NOLIST: Disable Source-Code 
Listing directive. 9**1 
.NOLISTIF: List True Conditional 
Statements directive. 971 
.NOLISTMACRO; Disable Macro 
Listing directive, 9 7 1 
NOLOCALS: Disable Local 
Symbols directive. 972 
/noiogo option, 125 
%NOMACS: List Only Macros that 
Generate Code directive. 972 
NOMASM51: Disable MASM 5.1 
Compatibility directive, 972 
NOMULTERRS: Disable Multiple 
Error Reporting directive, 973 
nonmaskable interrupt (NM1), 

168 

NOP: No Operation Instruction, 

834 

NOSMART: Disable Code 
Optimization directive, 973 
%NOSYMS: Disable Symbol Table 
in Listing File directive. 973 
NOT, 835 

NOT. Logical NOT instruction, 

835 


notation 

hexadecimal. 1** 
segment. I** 

%NOTRUNC: Control Word- 
Wrapping in the Listing File 
directive. 9"’-* 

NOW'ARN: Disable Warnings 
directive, 9~4-9“ f 5 
NPX 

detecting. 363-365 
functions. 731 
numbers, hexadecimal. 170 
numeric comparison instructions, 
734 

numeric constant instructions. 
733 

numeric coprocessors. 363-365, 
727, 967-968. 984-985 
numeric transcendental 
instructions. 7 33 


_O_ 

OBJ 

files. 85-89 

convening to BIN. 337 
debugging data, 157 
output file. 73 
records, suppressing. 154 
object 
code 

field width, 887 
files, 57 

relocatable. 67-86 
files, 122 

line numbers. 129. 157 
object-code files, linking. 137 
object-oriented programming, 
308 

OBJ RE AD assembler. 269 
OBJREAD.BAS file, 270 
offset bytes. 270-271 
OFFSET operator, 42 
open devices. 542 
Open command, 113 
Open File (Interrupt 21h, service 
3Dh) DOS service. 645-646 
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Open File. I sing F'CB ilnierrupc 
2lh. service UFh). 598-599 
opening 

files. (v»5-6-t(> 

FCB '98*599 

operand field. ASM files. “2 
operands. .M 

Operate ! inker in Batch Mode 
option. 9" 
operations 
libraries 2-* I 
statu- "so 

operator fields. ASM tiles. T 2 
operators 89 -* 
lu. ~ 5 
DL P. -i2 
looos. 88~-8H8 
OFF>ET. -»2 
sample use. 888 
optimizing code. 100-« 
disabling. 9" 3 
OPTION. Set Assembler 
Processing Parameters 
directive. 9"5-9"’"’ 
options 

A. 131 
VI. 119 

B. 131 
c. 120 
Cp. 120 
Cu. 120 
Cx. 120 
,D. 121 

Ep. 121 
/F. 118. 121 
/FI. 122 
Fb. 122 
/Fe. 122 
/Fm. 122 
/Fo. 122 
/Fpi. 123 
'FR. 123 
/Fr. 123 
Gc. 123 
/Gd. 124 
/H. 12 * 
help, 124 
1 . 12 -» 


nologo. 125 
1 *. 132 
S. 132 
SI. 126 
Sa. 125 
SI. 125 
Sg 126 
Sn. 126 
Sp. 126 
Ss. 126 
Si. 12" 

Sx 127 

V. 132 
VM. 12" 

W. 128 
w. 128 

X. 128 
Z. 132 
Zd. 129 
Zf. 129 
-Zi. 129 
Zm. 129 
Zp. 129 
Zs. 130 

Add Full Debugging Data to 
OBJ File. 15" 

Add No Debugging Data to 
OBJ File. 15*? 

.Align Segment Data. 9" 
.Alphabetic Segment Ordering. 

1 »9 

Assemble as a COM file 119 
.Assemble Onlv. 120 
assembler. 116-118, l-i'-l 
Check Purity of 286 380 Code. 
154 

command-line. 116-118 
NMAKE. 215 
variables. 118 
commands. 116 
Compile File. 115 
Control Warning Messages. 
156 

Create a listing File, 152 
Create an Expanded 1 istinc 
File 152 

Create Code f«>i Nunv.ne 

Coprocessors. I > ♦ 
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Create Debugger-compatible 
File. 93 

Create Overlays. 103 
Define an Identifier. 150-151 
Displav Help Information. 95. 
l-»9 

Display Progress of Linking 
Process. 101 

Display Source Lines with 
Errors. 15- 

Do Not .Associate Groups. 102 
Do Not Generate Any Listing 
File, 106 

Do Not Ignore Case 
Differences. 98 
Do Not Ignore Case 
Differences in Exports and 
Imports. 9" 

Do Not Pack Code Segments. 
103 

Do Not Translate FAR Calls. 
102 

Do Not Use Default Libraries. 
102 

Emulate Floating-Point 
Instructions. 151 
Enable 32-bit processing. 9" 
Exclude Tables from Listing 
File, 153 

Generate Detailed Segment 
Map. 105 

Generate Overlay Code, 153 
Generate Overlay Code with 
Phar-Lap-Sryle FLxups, 15-4 
Ignore Extended Dictionary, 

100 

Include Cross-References in 
the Listing File. 149*150 
Include Global Symbol Table 
in Lis; File. 101 
Include Line Numbers in List 
File. 101 

Include Line Numbers in 
Object File, 157 
Initialize All Segments. 100 
Issue Fixup Warnings. 106 
Jam Directive into Effect. 151 


LIB. 239 
linker. 92-95 
List False Conditional 
Statements. 156 
List Linker Options. 100 
Load Program in High 
Memory. 100 
MAKE. 21" 

Make AJI Names U ppercase. 
153 

Make Case of Global Symbols 
Significant. 153 
Make Case of Names 
Significant. 152 

Operate Linker in Batch Mode. 

9" . 

Order Segments by 
Occurrence in Source Code. 
155 

Override Default Include-File 
Path. 151 

Override Stack Size. 105 
Pack Contigous Code 
Segments. 103*10* 

Pack EXE File. 99 
Pad Code Segments. 10* 

Pad Data Segments. 10* 
passing, linker. 125 
Pause for Disk Change. 104 
Place DGROL P at High End 
99 

Prepare for Incremental 
Linking. 101 

Produce Binary Image File 

106 

Produce QuickLibrarv QLB 
File. 105 

Set Allocation Space, 98 
Set Assembler Emulation 
Version. 155 

Set Hash Table Capacity-, 152 
Set Maximum Valid Length for 
Symbols. 153 

Set Number of Passes. 152 
Set Overlay-Loader Interrupt 
Number. 103 

Specify Appliance Type. 104 
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Specify Executable File Tvpe. 
106 

Specify Library Search Path. 

101 

Specify- Maximum Segments. 
105 

Suppress Assembly- 
Completion Messages. 155 
Suppress Copyright Message. 
102 . 

Suppress OBJ Records Not 
Needed for Linking. 154 
Translate FAR calls where 
possible. 100 

Use Memory Swapping. 10” 
Use MS-DOS Segment 
Ordering, 99 
Use MS-DOS Segment 
Ordering without Nulls. 102 
Warn about Duplicate LIB 
Symbols. 98 
OR. 835 

OR: Logical OR instruction. 835 
Order Segments by Occurrence 
in Source Code option, 155 
ordering 

segments. 102. 131-132. 155. 
903-904 

alphabetic. 149. 885 
sequential. 1002-1003 
tracks. 451 

ORG: Specify- Starting Segment 
Address directive. 977 
%OUT: Output a String to the 
Screen directive. 977-9"8 
OUT statement, 414-416 
OUT: Output to Port instruction. 

835-836 

output 

auxiliary. 590 
characters. 589 
siring. 593-59-1 
ports, string words. 83” 
printer. 590-591 
string bytes to port.s. 836-83" 
string doubleword to ports 
83” 


strings to screen. 902. 908-909. 

9 -9“8 

to ports. 836-83 T 
Output Character (Interrupt 21 h. 

service 2) DOS service, 589 
Output Character String 
(Interrupt 21 h. service 9) DOS 
service. 593-594 
Output command. 1”8 
output Files. OBJ. 73 
OUTS. Output String to Port 
instruction. 836 
OUTSB: Output String Byte to 
Port instruction. 836-83" 
OLTSD: Output String 
Doubleword to Port 
instruction. 83" 

OUTSW: Output String Word to 
Port instruction. 837 
overflow, interrupting, 809 
overhead data. 262 
overlays. 8". 103. 153 
loading. 6”9 

Override Default Include-File 
Path option. 151 
Override Stack Size option. 105 


_P_ 

.? option. 132 
P switch. 18 
P186: Enable 80186 
Programming directive. 9"8 
P286: Enable 80286 
Programming directive. 
9”8-9"9 

P286N: Enable 80236 
Nonprotected-Mode 
Programming directive. 9"9 
P286P: Enable 80286 Protected- 
Mode Programming directive. 
9"9 

P28”: Enable 8028" 
Programming directive. 
9"9-980 

P386: Enable 80386 
Programming directive. 980 


0 


Scanned with CamScanner 








1108 ISinit Assembly Ijnguage. 3rd Edition 


P3H6V Enable 80386 
Nonprotected-Mode 
Programming directive. 980 
P.386P Enable 80386 Protected- 
Mndc Programming directive. 
981 

P 3 S" Enable 8038*' 

Programming directive. 981 
P486: Enable E0486 
Programming directive, 

981- 932 

P486N Enable 8 O -186 
Nonprotected-Mode 
Programming directive. 982 
P 8 U 86 Enable 8080 
Programming directive. 

982- 983 

P808* r . Enable 808“ 

Programming directive. 983 
I’ ick Com: ,uous Code Segment* 
option 03-10-4 
Pack F\T. I ile option. 99 
packing 

code segments. 103 
files, 99 

Pad Code Segments option, 10*4 
Pad Data Segments option. 104 
PAGE directive. 126 
PAGE Listing-File Page Control 
directive, 983-984 
pages 

code, global. 718 
0 ntrol. li ning files, 983-984 
d mcnsions, listing files; 984 
tVGESIZE: Set Listing-File Page 
' mentions directive. 984 

pi'cttes 

*oloi *93-49*4 

HtiAVi ;.\ registers. * 499-500 
parallel connector. 439 
parameters. 116 
blank. l-t~ 
blocks. 2So 
commas. 138 
drives. Sp 
formal 81 
formatting. 256 


passing. 123. 2 
single. 332 

to subroutines. 255*260 
placement. 256 
procedures, stack frame. 

““2- 3 

processing, setting. 9 " 5 - 9 ““ 
semicolons. 138 
stacks. 256-260 
values, accessing. 2“2 
Park Heads (Interrupt 13k- 
service 19h) BIOS service. 529 
parking 
heads. 529 
structures. 129 
Parse File Name. I sing FCB 
(lnterrupr 21 h service 29h) 
DOS service. 62 - 1-625 
parsing. 5 “ 

filenames. 62-4-625 
Pascal 

interfacing with assembly 
language. 233-292 
strings, storage. 320 
passing. 58 

addresses, string. 299 
arguments, stacks. 885-886 
options, linker. 125 
parameters. 123. 277 
single. 332 

to subroutines. 255-260 
pointers, variable, 295-301, 31 ,s 
setting number. 152 
single-pass assembler. 58 
symbols. 129 
to subroutines. 2] 
two-pass assembler, 58 
values onto stack. 310 
variables. 285-286, 29 ’.? 9 s 
3*43*3-16 “ 3 - 

integer, 273 
subroutine interface 
315-318, 346*348 ’ 

to subroutines. 310 

paths 

directories. 6“-4-6"5 
include-filc. i 2 -» 
search, r; libraries. 13 ~ 
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Pause for Disk Gunge option. 

104 

%PCNT: Set Listing-File Address- 
Field Width directive. 98-* 
PC-oriented assemblers. 58 
period ( ). 328 

peripherals, communication. 3^8 
phase error problems. 68 
pixels. 495-49~ 

Place DGROI P at High End 
option. 99 

placement, parameters. 256 
placing 

data on stacks. 839-840 
Hags 

extended. 84 1 
on stacks. 840-841 
plus sign (4-) operation code. 

239' 

PN08”; Disable Numeric- 
Coprocessor Programming 
directive. 984-985 
pointers. 299 

data, returning. 318-320 
FAR. 309-311 
Files, moving. 650-651 
instruction, register. 24 
NEAR. 311 
stack. 24 

incrementing. 783 
specifying. 1004 
strings, processing, 323-325 
table, including. 1012-1013 
types, defining. 1016 
variable, passing. 295-301. 318 
Pointing Device Interlace 
(Interrupt 15h, service C2h) 
BIOS service. 552-553 
POKE statement. 2 7 5 
polling, 26 

pop-up windows. 400 
POP: Remove Data from Stack 
instruction. 83~-838 
POP.v POP All General Registers 
instruction. 838 
POPAD POP All General 
Doubleword Registers 
instruction. 838 


POPCONTEXT: Restore 
Assembler Environment 
directive. 985 

POPF Remove Flags from Stack 
instruction. 849 

POPFD Remove Extended Flags 
from Stack instruction. 839 
popping, general registers. 838 
%POPI.CTL: Restore lasting 
Controls directive. 985-986 
pons 

8259 command port. 4 19 
addresses. 4 13 

EGA adapters. 436 
printers. 4 39, 44 1 
ranges. 431 
VGA adapters. 456 
communications 

asynchronous. 4 41-445 
control. 536-53” 
initializing. 536-536 
status, 534-535 
hardware. 4 13-41' 

addresses. -»13. 418-445 
1 O. 4 I 4 

addresses. 4 16-417 
map. 4 16-418 
input. 806-808 
output. 836-83” 
printer. 4 39-440 
retrieving bytes, 1^6 
status, adapter cards, 382 
strings, output to. 836 
transferring data. 415 
video controller. 431*433 
position, cursor. 82-83. 2~0. 480 
PP1 (Programmable Peripheral 
Interace). 421-424 
Prepare for Incremental Linking 
option. 101 

preprocessing directives. 213 
Print Character (Interrupt l"h. 

service 0) BIOS service. 562 
Print Screen (Interrupt 5) BIOS 
service. 476 

printer output. 590-391 
Printer Output (Interrupt 2in. 
service 5) DOS service. 59 * 
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printer-control register, 440 
printer-status register. 439 
printers 

initializing, 363 
ports, 439-441 
setup, 701-703 
status. 563-564 
printing, 30 

characters, 389, 562 
screen, 476 
strings. 30 
privilege level, 361 
PROC: Start a Procedure 
directive, 986-987 
PROCEDURE statement. 284 
procedures, 53 
directives, 874 
ending, 915-916 
executing, 955 
FAR, 52-53. 257-258 
invoking. 52 
NEAR. 52, 257 
prototypes, declaring, 988 
starting, 986-987 . 

Proceed command. 178 

Process Terminate (Interrupt 
21h, service 4Ch) DOS service 
681 

processing parameters, setting. 
975-977 

processor control instructions. 2 4 

processor- and flag-control 
instructions. 36, 735 

processors 

80186. 878-978 
80286, 728. 879-880. 9~8-979 
80287, 730. 880. 979-980 
80386, 729, 880-881. 980-981 
80387. 730. 881-882, 981 
80486, 729, 882-883. 981-982 

8086. 883-884. 982-983 
8086/8088. 728 

8087, 730. 884, 983 
coprocessors, numeric, 

363-365. 727. 967-968 
984-985 

CPU. determining type, 35"' 


initializing, 733-784. 791 
specifying, directives, 872 
Produce Binary Image File 
option. 106 

Produce QuickLibrary QL3 File 
option, 105 

Professional Development System 
(PDS). 266 

Profilers. 223-228, 231-235 
program sections. 49 
program segments. 49 
Programmable Option Select 
(Interrupt 15h. service C4h) 
BIOS service. 554 
Programmable Peripheral 
Interace (PPI), 421-424 
Programmer's Workbench. 114 
commands, issuing, 113 
loading, 112 
MASM 6 0. 112 
screen. 113 
shell. 112 

programming architecture. 13 
programming models, 728-730 
programs 
addresses. 20 
analyzing. 224 
controlling. 467-469 
debuggers 

CodeView, 166 
DEBUG. 166 
Turbo Debugger. 166 
entry point, specifying. 

1005-1006 

execution, conditional, 

909-914. 944-945 
exit point. 934-935 
LIB. 238-243 
loading. 6*"!’-6~8 
maintenance, libraries 
.238-239. 2-48 
ML 116 

sample. 159-160 
segments, prefixes. 706 
subprograms. 302-305 
terminating. 543. 58--5R8 
testing. 140. 162-163 
TLIB. 239-2 n 
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prompts, clot. 3-8 
protected mode, 25. 5-»8-549, 

*”8. "96 

Protected Mode Switch (Interrupt 
15h. service 89h) BIOS service. 
548-549 

PROTO. Declare Procedure 
Prototype directive. 988 
prototypes 

declaration. 31" 
procedure, declaring. 988 
pseudo-targets. 209 
pseudooperators. 72 
public symbols, 129 
PUBLIC! Declare Symbols as 
PUBLIC directive. 983-989 
PUBLICDLL: Declare Symbols as 
PUBLIC for Dynamic Link 
Libraries directive. 989 
pure source code. 132 
PURGE directive. 82 
PURGE: Delete Macro Definition 
directive. 990 
PUSH: Place Data on Stack 
instruction. 839-8-»0 
PUS HA. Push All General 
Registers instruction. 8-*0 
PUSHAD: Push .All General 
Doubleword Registers 
instruction. 840 

PUSHCONTEXT. Save Assembler 
Environment directive. 990 
PUSHF: Place Flags on Stack 
instruction. 840-8-*l 
PUSHFD. Place Extended Flags 
on Stack instruction. 841 
pushing 

general registers. 840 
values, stacks, 294 
%PUSHLCTL: Temporarily Save 
Listing Controls directive. 991 


_Q 

QBasic. 2"’5-2"8 
quadwords 

allocating storage space. 
905-906 


doublewords, converting from. 
766 

storage space. 991-992 
Query Drive (Interrupt 2in- 
service 4-»h. function 1 lh> DOS 
service. 6"l-6"2 
Query Handle (Interrupt 2 Ih. 
service 44h. function 10h> DOS 
service, 671 
querying 

drives, 6" 1-672 
handles. 6” 1 
question mark (?). 1 > 1 
queues 

last-in, first-out. 21 
lookahead. 415 
Quick Library' QLB file. 2~9 
QuickAssembler. 68-69. 31 + 
QuickBASIC. 265-266. 2~5 
QuickC. QuickAssembler 31+ 
QUIRKS. Enable Handling of 
MASM Quirks directive. 991 
Quit command, H9 
QVC'ORD: Allocate a Quad word ot 
Storage Space direct, 991-992 


R (restore) byte. 336 

.RADIX: Specify the Default Radix 
directive. 992 
radix, default. 992-993 
RADIX. Specify the Default Rad lx 

directive, 993 

RAM character generator. 3 "> 
Random Read. Using FCB 
(Interrupt 21h, service 21h) 
DOS service. 615-616 

Random Write. Using FCB 

(Interrupt 2lh, service 22h) 
DOS service. 616-617 
RCL: Rotate Left through Carr) 
instruction. 8+1 
RCR. Rotate Right through 

instruction, 8+2 

Read .Alarm (Interrupt l.Ah 
service 9) BIOS service. 5 1 
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Read Character and Attribute 
(Interrupt 10 h. service 8 ) BIOS 
service. 490-491 
Read (.ursor Position and Si 2 e 
(Interrupt 10 h. sen ice 3) BIOS 
sen ice. 480-481 

Read DASD Type (Interrupt 13h. 
service 15h) BIOS senice. 
525-326 

Read Data Blocks from Cassette 
(Interrupt 15h. senice 2) BIOS 
senice. 538-539 

Read Date from Real-Time Clock 
(Interrupt lAh. senice 4) BIOS 
senice. 568-569 

Read Disk Sectors (Interrupt 1 3 h. 
senice 2) BIOS senice 
509-511 

Read Disk-Change Line Status 
(Interrupt 1 Ah. senice 16h) 
BIOS senice. 52(>-52 T 
Read File (Interrupt 21 h. senice 
3Fh) DOS seniccs. 6 -*"- 6-*8 
Read Keyboard Character 
(Interrupt I 6 h sen ice f>) BIOS 
senice. 554-555 
Read Keyboard Shift Status 
(Interrupt 16h. senice 2) BIOS 
senice. 55"-558 

Read Keyboard Status (Interrupt 
• 16h. senice l> BIOS senice. 
556-55* 

Read Light Pen Position 
(Interrupt lOh. senice -*) BIOS 
senice. 431-482 
Read Long Sectors (Interrupt 
13h. sen ice OAh) BIOS senice 
518-520 

Read Pixel Doc (Interrupt lOh. 
senice ODhl BIOS senice 
- 196 - 19 - 

Read Random Record(s). Using 
FCB (Interrupt 21h. senice 
2'h) DOS senice. 621-622 
Read Real-Time (.lock (Interrupt 
lAh. senate 2) BIOS senice. 

16- 


reading 
alarm. 5 7 1 

characters, keyboard. 554-555 
errors, multiple. - 9*3 
files. 6 -P -648 
records, random.*621-622 
sectors. 451 
disk. 509-511 
long. 518-520 

segments, verifying, 866 - 86 " 
reads. disk, absolute. 723-*2-i 
real mode. 25. *28 
real-time clock. 56*-569 
REAL 10: .Allocate 10 Bytes of 
Storage Space for an 80-Bit 
Floating-Point Number 
instruction. 995 

RH.AL 4 : .Allocate a Doubleword of 
Storage Space for<i 32-Bit 
Floating-Point Number 
instruction. 993-99-* 

REALS. Allocate a Quadword of 
Storage Space for a 64-Bit 
Floating-Point Number 
instruction. 994-995 
Receive C haracter (Interrupt l 4 h. 
senice 2) BIOS senice 
533 - 53 -* 

RLCORD: Define Records 
directive. 996 
records. -»51 
defining. 996 
OB;, suppressing. 15 .* 
random 

reading 621-622 
writing. 622-624 
Redirect Device (Interrupt 2lh 
service 5Fh. function 03h) DOS 
senice. 704-"05 
redirection 

canceling. 705-"06 
devices. "04-705 
list entry, " 03-"04 
referenced variables, cross- 
relerencing. 896-89- 
references, external. 245 

Register command. 1-9 | 9 - 
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registers. 22 
80286. 25 
80586. 25 
80486.25 

8086 8088 register set. 22 
additional, 25 
addresses. 15 
addressing, -n 
base, 47 

base point (BP). 25 7 
component bytes, 25 
descriptor table, 728 
interrupting, 862 
storing. 862 

displaying. DEBUG, 197 
DS. 822-823 
ES. loading. 823 - 82-4 
exchanging, 803 
. flags, "46 

8086.8088, 23 
pushing onto stack. -P3 
freeing. 780 
FS. loading. 82-i 
GDT 

loading. 82-i 
storing, 860 
general 

doubleword. 838 - 8-40 
popping. 838 
pushing. 840 

global descriptor table (GDT), 
25 

GS, loading. 825 
IDT, loading, 825 
index, 47 

instruction pointer. 24, 257 
interrupt descriptor table 
(IDT), 25 

interrupt-identification. 

442-443 

LDT, loading. 825 
line-control, 443 
line-status, 444 
locai descriptor table (LDT), 
25 

matching status word (MSW). 
25 


mode-control. 423 
modem-control, -4-m 
modem-status. 4-4 5 
monochrome display-adapter, 
432 

palettes. EGA VGA. 499-500 
printer-control. 440 
printer-status. 439 
saving, specifying, 1020-1021 
segments. P 
assigning. 886 
code. 24 
data. 24 
extra. 24 
secondary. 24 

special-purpose, saving. 310 
specialized. 7-45-746. 7 51-753 
SS. loading. 830 
task. 25. 830, 865 
values 

displaying. 179 
returning. 261 
RELEASE MODULE xBase 
command. 328 

relocatable object code, 67-86 
relocatable routines. 274 
Remove Subdirectory (Interrupt 
21h, service 3Ah) DOS service, 
643-644 
removing 

data, from stacks, 838 
flags, from stacks, 839 
subdirectories. 643-644 
Rename File (Interrupt 21h, 
service 56 h) DOS service. 686 
Rename File, Using FCB 
(Interrupt 21h, service 17h) 
DOS service. 608-609 
renaming files. 608-609, 686 
REP: Repeat instruction, 842 
REPE: Repeat if Equal Instruction, 
842-843 
.REPEAT loop 

ending. 1018-1020 
modifying execution, 894-895 
terminating, 887-888 
repeat blocks, directives. 875 
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.REPEAT Declare the Beginning 
of a Controlled Loop directive 
996-99- 
repeat rate. 558 
REPEAT: Repeat a Block of 
Instructions directive. 997 
repeating. 8-42-844 
blocks 

instructions. 940-941, 
955-956. 99~-998. 1024 
REPNE: Repeat if Not Equal 
instruction, 8-*3 
REPNZ. Repeat if Not Zero 
instruction. 843 
reporting errors, multiple, 966 
REPT directive. 81 
REPT: Repeat a Block of 
Instructions directive. 998 
REPZ. Repeat if Zero instruction 
8-44 

reserving memory. 2~4 
Reset Disk (Interrupt 2lh, service 
ODh) DOS service. 596 
Reset Disk Drives (Interrupt 13h 
service 0) BIOS service 
507-508 

resetting disks, 596 
response files, 139-140 
libraries, 246-248 
TLINK, 161-162 
restoring 

environment, 985 
listing controls. 985-986 
screen, 333-336 
RET instruction. 72 
RET statement. 291 
RET: Return from Subroutine 
instruction, 844 
RETURN command. 52 
Return Drive Parameters 
(Interrupt I3H, service 8) BIOS 
service, 517 
returning 

from subroutines. 844 
strings 

length 1003 
substrings. 1008-1009 
substrings. 1008-1009 


values. 260-261 
returns 
far. 172 
near. 1~2 
RIP command. 195 
ROL. Rotate Left instruction. 

844-845 
ROM-BIOS, 26 
root names, files. 137 
ROR: Rotate Right instruction, 
845 

rotating, 841-845 
routines 

assembling, 110 
assembly language, converting 
to, 266 S 6 

BIN-file. 331 
Exiend-System, 347-353 
formatting, 452-467 
functions, declaring as. 302 
graphics, text-based. 394-400 
library, run-time. 342 
relocatable. 274 
storing, 266 
run-time system. 30 


S 

S (save) byte, 336 

/S option, 132 
/SI option, 126 
/Sa option, 125 
SAHF: Store AH into Flags 
Register instruction. 845 
SAL: Arithmetic Shift Left 
instruction. 846 
SAEL. Disable Macro Listing 
directive, 998 
sample analysis. 224 
sample programs. 159-160 
SAR. Arithmetic Shift Right 
instruction, 846 

saving 

environment. 990 
listing controls temporarily, 


registers, specihw 
1020-1021 ' **’ 
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screen. 333-336 
windows. 400--*10 
SBB: Subtract with Carry- 
instruction. 846-84 ‘ t 
SBYTE: Allocate a Signed Byte of 
Storage Space directive. 999 
scale, 796 
scan line, 479 
scanf() function, 199 
scanning strings, 847-848 
SCASB: Scan String for Byte 
instruction, 847 
SCASD: Scan String for 
Doubleword instruction, 

847-848 

SCASW: Scan String for Word 
instruction, 848 
scope directives. 874 
scratch pad. 443 
screen 
blank 

white-on-black. 323 
writing to. 2 T 2 
character position, memory'. 

367 

clearing color, 271 
CodeView, 199 
output from strings. 908-909 
printing, 476 

Programmer’s Workbench, 113 
reading, 323 
restoring, 333-336 
saving. 333-336 
snow, 382 

strings, output to, 902, 

977-978 

Scroll Window Down (Interrupt 
lOh, service 7) BIOS service. 
489-490 

Scroll Window Up (Interrupt lOh, 
service 6) BIOS service, 

484-489 

scrolling windows, 484-490 
SDWORD: Allocate a Signed 
Doubleword of Storage Space 
directive, 999-1000 
Search command, 179 - 180 , 193 


Search for First File-Name Match 
(Interrupt 21h. service 4Eh» 

DOS service. 682-683 
Search for First File-Name Match. 
Using FCB (Interrupt 21h. 
service llh) DOS service. 
600-602 

Search for Next File-Name Match 
(Interrupt 21h, service 4Fh) 

DOS service, 684 

Search for Next File-Name Match. 
Using FCB (Interrupt 21h. 
service 12h) DOS service. 
602-603 

search paths. C libraries. 137 
searching memory blocks. 179-180 
secondary segment register. 24 
sections, program. 49 
sectors 

bad, 515-516 
boot. 452 
disk 

loading. 1 7 7 
verifying. 513-314 
writing, 511-513 
per track. 450 
specifying, 448 
reading. 451, 509-511 
long, 518-520 
writing 

long, 521-522 
writing to disk, 181 
Seek Cylinder (Interrupt 13h, 
service OCh) BIOS service, 
523-524 

segment assumptions, 48 
SEGMENT: Define Beginning of a 
Segment directive, 1000-1002 
segments, 50-51 
addresses. 49 
starting, 977 
aligning, 50 

beginning, defining, 898-899, 
1000-1002 
code 

packing, 103 
padding, 104 
registers, 24 
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data 

far, 939-940 
naming. 310 
padding, 104 
register, 24 

uninitialized, 1016-1017 
ending, 916 
extra, register, 2 -* 
gapi, reducing, 97 
grouping common. 944 
initializing, 100 
limits, loading, 829-830 
maps, 105 
memory, 17, 49 

memory management, 308 
naming. 310 
notation. 17-18 
ordering 99. 102, 131-132 
155.903-904 
alphabetic, 149. 885 
sequential, IOOMO 03 
prefixes. 620-621 
program. 49 
prefixes, 706 
registers. 1 ', 24, 886 . 
secondary, registers. 21 
stack 

beginning. 100 *-100 5 
BIN files, 329 
register, 24 
string operations, 24 
value, 17 

verifying, 866-867 
Select Active Display Page 
(Interrupt lOh, service 5 ) BIOS 
service, 483-484 
semicolons, parameters, 138 
.SEQ: Place Segments in 
Sequential Order directive 
1002 

SEQ: Place Segments in 
Sequential Order directive 
1002-1003 

sequential order, segments 
1002-1003 

Sequential Read, Using FCB 
(Interrupt 21h, service l-»h) 
DOS service, 604-605 


Sequential Write, Using FCB 
(Interrupt 2 lh, service 15h) 
DOS service, 606-607 
services. DOS, 575-726 
Set Alarm (Interrupt lAh, service 
6 ) BIOS service, 569-570 
Set Allocation Space option. 98 
Set AUocation Strategy (Interrupt 
21 h, service 58h, function Olh) 
DOS service, 689 

Set Assembler Emulation Version 
option, 155 

Set Clock Counter (Interrupt 

lAh, service 1 ) BIOS service, 

5 06 

Set Color Palette (Interrupt 10 h 

service OBh) BIOS service 

493-494 * 

Set C trl Break Flag (Interrupt 

i -»rw SCn ' Ce ?3hl faction Olh) 
uos service, 633-634 

SET CL RvOk function, 3 *3 

Set Cursor Position (Interrupt 

\(>h service 2, BIOS service, 

Set Cursor Size (Interrupt 10h 
service 1 > BIOS service, 479 
Set DASD Type for Format 
(Interrupt 13h, service 17h) 

BIOS service, 527-f 28 
Set Date of Real-Time Clock 
(Interrupt LAh, service 5 ) BIOS 
service. 569 5 

Set Day Count (Interrupt LAh 
service OBh) BIOS service. 572 
Set Default Drive (Interrupt 2lh 

service OEh) DOS service 597 

Set Device Information (Interrupt 
21 h, service <*4h function 01M 
DOS service, 654-655 ^ 

Set Directory (Interrupt 2lh 
service 3Bh) DOS service 644 
Set Disk Transfer Area (DTA) 
(Interrupt 21h, service lAh\ 

DOS service, 6 10 ' 

Set Execution State (lnier«. 

2lh. service 4Bh, C ct ^ P n 
DOS service, 680 nCt, ° n <>5h) 
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Set Extended-Error Values 
(Interrupt 2 Hi, service 50h, 
function OAh) DOS service. 
699-^00 

Set Hash Table Capacity option. 

152 

Set High-Memory Link Status 
(Interrupt 21h. service 58h. 
function 03h) DOS service. 690 
Set Interrupt Vector (Interrupt 
21h. service 25h) DOS service, 
620 

Set Logical Device Map (Interrupt 
21h, service 44h function OFh) 
DOS service. 670 
Set Maximum Valid Length for 
Symbols option. 153 
Set Media Type for Format 
(Interrupt I3h. service 18h) 

• BIOS service, 528-529 
Set Number of Passes option. 152 
Set Overlay-Loader Interrupt 
Number option, 103 
Set Printer Setup (Interrupt 21h. 
service 5Eh, function 02h) DOS 
service. 701-702 
Set PSP Address (Interrupt 21h. 
service 50h) DOS service. 
684-685 

Set Random Record Field in FCB 
(Interrupt 2 lh, service 24h) 
DOS service. 619 
Set Real-Time Clock (Interrupt 
LAh, service 3) BIOS service. 
567-568 

Set Sharing Retry Count 
(Interrupt 21h. service 44, 
function OBh) DOS service. 
666-667 

Set System Date (Interrupt 21h. 
service 2Bh) DOS service. 
626-627 

Set Time (Interrupt 21h, service 
2Dh) DOS service. 628-629 
Set Verify Flag (Interrupt 21h. 
service 2Fh) DOS service. 
629-630 


Set Video Mode (Interrupt lOh. 
service 0) BIOS service. 

-i -h~8 

SETA. Set Byte if Above 
instruction. 8-»8-8-*9 
SETAE Set Byte if Above or Equal 
instruction. 8-*9 
SETB: Set Byte if Below 
instruction. 8-*9 

5F.TBE: Set Byte if Below or Equal 
instruction, 849-850 
SETC: Set Byte on Carry 
instruction, 850 
SETCOLOR() function. 343 
SETE: Set Byte if Equal 
instruction. 850 
SETG: Set Byte if Greater 
instruction. 851 
SF.TGE. Set Byte if Greater or 
Equal instruction, 851 
SET! : Set Byte if Less instruction. 
851-852 

SETLE: Set Byte if Less or Equal 
instruction, 852 
SETNA: Set Byte if Not Above 
instruction, 852 

SETNAE: Set Byte if Not Above or 
Equal instruction. 852-853 
SETNB: Set Byte if Not Below 
instruction, 853 

SETNBE: Set Byte if Not Below or 
Equal instruction, 853 
SETNC: Set Byte on No Carry 
insuiiction, 854 
SETNE: Set Byte if Not Equal 
instruction. 854 
SETNG: Set Byte if Not Greater 
instruction. 854-855 
SETNGE: Set Byte if Not Greater 
or Equal instruction. 855 
SETNL: Set Byte if Not Less 
instruction. 855 
SETNLE: Set Byte if Not Less or 
Equal instruction, 856 
SETNO Set Byte on No Overflow 
instruction. 856 
SrTNP. Set Byte on No Parity 
instruction. 8S6-85 
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SETNS Set Byte on Not Sign 
instruction 85' 

SETNZ Set Byte if Not Zero 
instruction. 85^ 

St TO: Set Byte on Overflow 
instruction. 85“-858 
SETP Set Byre on Parity 
instrucuon. 858 
SETPE: Set Byte on Pari tv Even 
instruction. 858 
SETPO: Set B>te on Parirv Odd 
instruction, 859 
SETS: Set Byte on Sign 
instruction. 859 
setung 

bytes, 848-860 
carry flag 863 
day count. 5^2 
direction flag. 863 
directories. 644 
flags. 24 

interrupt flag, 864 
processing parameters, 
975-977 


protected mode, 796 
verify flags, 629-650 
SETZ: Set Byte if Zero 
instruction, 859-860 
/Sf option, 125 

SFCOND: List True Conditional 
Statements directive. 1003 
/Sg option. 126 
SGDT: Store GDT Register 
instruction, 860 

shell, Programmer's Workbench 
112 

shift left, bits, 860 

double precision, 861 
shift right, bits. 861 


double precision, 861-862 
SHL: Shift Left instruction 860 
SHLD Shift Left, Double 
Precision instruction. 861 
SHR; Shift Right instruction 861 
SHRD: Shift Right, Double 
Precision instruction. 861-862 
S 1 DT Store Interrupt Descriptoi 
Table Register instruction. 86 i 




simplified segment control 
directives. 8 7 3 
sine. “96-"9" 

single-pass assemblers. 58. 6 “ 
single-pass compiler. 121 
size 

buffers. 131 
code. 451-452 
cursor. 4^9 

extended memory. 548 
memory. 507 

Size Extended Memorv (Interrupt 

l^h. service 88 h) BIOS service 
548 

SIZES 1 k: Return the Length of a 
String directive. 1003 
skeleton, subroutine 5 VSS 
slash (/) delimiter. 95 
SLOT: Store Local Descriptor 

q Jfk'o-? egl5ter instruction. 862 
SMALLSTAC 1 C Specify 16-Bit 
Stack Pointer directive, 1004 
SMART: Enable Code 
Optimization directive, 1004 
SMSW: Store Machine Status 
Word instruction, 863 
/5n option, 126 
snow on screen, 382 
software 

controlling, 14 
debuggers, 167 
DEBUG, 169-171 
environment, 14 
interrupts,^, 808-809 
source code 

inserting. 953-954 
listings. 959 

disabling, 970-971, 1026 
pure, 132 

translating to machine 
language, 265 
window. 202 
source lines. 157 
source files 
ASM. 71-73 
browser, ] 23 
Clipper, 3ii 
end. designating. 543 
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extended, 123 
extensions, C, 318 
source listing files, 122 
source-level debuggers, 184 
spacing commands, 31 
speaker, controlling, 428*430 
specialized registers, 745-746, 
751-753 

Specify Appliance Type option, 
104- 

Specify Executable File Type 
option. 106 

Specify Library Search Path 
option, 101 

Specify Maximum Segments 
option, 105 
specifying 

compatibility, version, 1021 

defaults, radix, 992-993 
entry point, program, 
1005-1006 
executable files, 122 
format, floating-point, 966 
languages, 309 
models, memory, 964-966 
pointers, stack, 1004 
processors, directives, 872 • 
registers to save, 1020-1021 
subtitles, listing files, 
1009-1010 
square root, 797 
/Ss option, 126 
SS register, loading, 830 
STACK: Define Beginning of 
Stack Segment directive, 
1004-1005 

stack pointer (SP), 24 
stack segment register (SS), 24 
STACK segments, BIN files, 329 
STACK: Define Beginning of 
Stack Segment directive, 1005 
stacks, 20-21 

addresses, pushing, 272 
arguments, passing, 885-886 
data 

placing, 839-840 
removing, 838 


flags 

extended, 841 
placing, 840-841 
removing, 839 
last-in. first-out queue, 21 
parameters, 256-260 
passing values, 310 
pointers 

incrementing, 783 
specifying, 1004 
pepping, 53 
pushing 

address words on, 53 
values, 294 
segments 

beginning, 1004-1005 
registers, 24 
size, 105 

overriding, 121 
values 

returning, 260 
variable, 317 

start-up code, invisible, 184 
starting, procedures, 986-987 
.STARTUP: Specify Program Entry 
Point directive, 1005 
STARTUPCODE: Specify Program 
Entry Point directive, 1006 
statements 
BASIC, 30 
CALL, 272, 332 
CALL ABSOLUTE, 277 
conditional 
false, 156 

listings, 893, 958-971, 

1003, 1015 
true, 968 
DATA. 269-270 
IN, 414-416 
inline, 289, 314 

converting from files, 298 
inline(), 283 
LOCATE. 270 

machine language, executing, 
* 175 
MOV, 414 
OUT, 414-416 
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POKE. 2'5 
PROCEDURE. 284 
RET. 291 
status 

equipment, 505-506 
floppy disks. 508-509 
keyboard. 556-558. 561 
light pen, 482 
machine, word. 826 
operations. 746 
ports, communications, 
53*-535 

printers. 563-564 
word. 752-753 
storing. 792-793 
status() function, 200 
status-flags, 189 
STC: Set Carry Flag instruction 
863 

STD: Set Direction Flag 
instruction. 863 
STI: Set Interrupt Flag 
instruction. 864 
storage, data. 40-44 
storage space 

allocating. 888-889. 901-906 
bytes. 899-900, 941-942 
999, 1013 

doublewords, 900-901 908 
999-1000 

quadword, 905-906, 

991-992 

words, 907. 1025 
words, signed, 1010-1011 
storing 

control word. 792 
descriptor table register, 862 
environment. 792 
GDT register, 860 
integers. 784 

machine status word. 863 
routines 

memory, 266 
string variables, 266 
status word. 792-79t 
subroutines, variable space, 266 
task register. 865 


STOSB: Store Byte in AJL at String 
instruction, 864 
STOSD: Store Doubleword in 
EAX at String instruction, 864 
STOSW: Store Word in AX at 
String instruction, 865 
STR: Store Task Register 
instruction, 865 

string-manipulation instructions 
34. 734 
strings 
addresses 

calculating, 277 
passing, 299 

ASCII, displaying. 384-386 

BASIC. 266 

bytes 

input from pons. 807 
. output to ports, 836-837 
character, output. 593-594 
comparing 

byte-for-byte, 768 
doubleword-for- 
doubleword, 769 
word-for-word, 769 
concatenation, 889-890 
control, directives, 876 
converting, 716-718 
descriptors, 270, 276 
different, generating errors 
921-928 
doublewords 

input from port. 808 
output to port. 837 
identical, generating errors 
923-925. 929 
length. 279 
GW-BASIC. 275 
renaming. 1003 
manipulation, mnemonics 
368 

moving 

byte-by-byie. 831 
doublcword-by- 
doublcword, 832 
word-by-word. 832 
operations, segments. 24 
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output 

to ports. 836 
to screen. 902. 977-9~8 
placing subroutines. 267 
ports, input. 807 
printing, 30 

processing with pointers, 
323-325 
scanning 

for bytes. 84 7 
for doublewords, 847-848 
for words, 848 
screens, output to. 908-909 
storage 
C. 320 
Pascal, 320 
substrings, returning. 

1008-1009 
subtitles, 126 

variables, storing, routines. 266 
words 

input from port, 808 
output to port, 837 
writing, 503-505 
STRUC: Define a Data Structure 
directive. 1006-1007 
STRUCT: Define a Data Structure 
directive, 1007-1008 
structure. 31-32 
structures 

data, defining, 1006-1008 
ending. 916 
parking, 129 

SUB: Subtract instruction, 
865-866 

subdirectories. 115 
creating, 642-643 
removing, 643-644 
subprograms, 302-305 
subroutines, 52-53 

assembling, 110, 143-145 
callable. 473 
calling, 765 
interfacing, 256 
Clipper, 342-351 
returned values. 349-350 
variable passing. 315-318, 
346-348 


invoking. 255 
library, updating. 250 
linking. 23‘ 7 

passing parameters. 255-260 
passing to. 21 
placing in strings. 267 
poking to reserved memory. 273 
returning from, 844 
skeleton. 53-55 
storing, variable space. 266 
string variables, passing. 261 
variables, passing. 310 
'SUBSTR: Return a Substring 
directive. 1008-1009 
substrings, returning. 1008-1009 
SUBTITLE directive. 126 
SUBTITLE: Specify Listing-File 
Subtitle directive, 1009 
subtitles 

listing files, specifying, 

1009-1010 
listings. 126 
strings, 126 

subtracting integers, 784-785 
subtraction, 84 7 , 865-866 
SUBTTL: Specify Listing-File 
Subtitle directive, 1009-1010 
%SUBTTL: Specify Listing-File 
Subtitle directive, 1010 
Suppress Assembly Completion 
Messages option, 155 
Suppress Copyright Message 
option, 102 

Suppress OBJ Records Not 
Needed for Linking option. 154 
switches. 92, 116 
/P, 18 

assembler, 147 
configuration. 421 
protected mode, 548-5-49 
SWORD: Allocate a Signed Word 
of Storage Space directive, 

1010-1011 
symbol characters 

external, limiting. 124 
symbol tables 
listing files, 1011 
listings. 126 


X: 
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symbols 

convening to uppercase. 153 
defined, generating errors, 
920-921,926-927, 931*932 
defining, 956-957 
duplicate, 98 
length, 153 
local 

disabling, 972 
enabling, 961 
maximum, 152 
passing, 129 
PUBLIC, 988-989 
public, 129 

%SYMS: Enable Symbol Table in 
Listing File directive. 1011 
syntax, checking, 130 
SYS() function, 332 
SysRq Key Pressed (Interrupt 15h, 
service 85h) BIO, 545*546 
system configuration, 549-551 
system time. 627 


_T__ 

table pointers, including, 
1012-1013 

TABLE: Define a Method Table 
directive, 1011-1012 
tables 

disk base, 449-450 
fixed disk, 517-518 
method, defining, 1011-1012 
symbol 

listing files, 973,1011 
listings, 126 
uppercase, 710-712 
%TABS1ZE: Set Listing-File Tab- 
Stop Width directive, 1012 
tangent, 794 
target files, 209 
task register. 25, 830,865 
task-switched flag, clearing, 767 
tasks, 26 
TASM 3.0 

assembler. 143-147 
batch files, 157-159 
directives, 38-39 


TBLPTR: Force Table-Pointer 
Inclusion directive. 1012-1013 
TBVTE: Allocate 10 Bytes of 
Storage Space directive, 1013 
temporary files. 92 
creating. 696-697 
Terminate Address (Interrupt 
22h) DOS service. 723 
Terminate and Stay Resident 
(Interrupt 21h. service 3lh) 

*. DOS service. 631-632 
Terminate and Stay Resident 
(Interrupt 27h) DOS service, 
726 

Terminate Program (Interrupt 
15h, service 82h) BIOS service, 
543 

Terminate Program (Interrupt 
20h) DOS service, 587 
Terminate Program (Interrupt 
21h, service 0) DOS service, 
587-588 

terminate-and-stay-resident, 
631-632. 726 
terminating 
addresses, 723 
loops 

REPEAT, 887-888 
WHILE, 887-888 
programs, 543, 587-588 
test bits, 866 

TEST.EXE, debugging, 190 .191 
TEST: Test Bits instruction, 866 
testing 
bits, 763 
profilers, 232 

programs, 140,162-163 232 
values, flags, 24 

%TEXT: Set Listing-File Source- 
Field Width directive, 1014 
text files, ASCII, 72 
text macros, defining, 1014 

TEXTEQU: Define a Text Macro 
directive, 1014 
.TFCOND: Switch State of 

Conditional-Statement List 

directive, 1014-1015 
time, setting, 628-629 
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timers 

8253 timer. 420-421 
watchdog. 553 
timing analysis. 228-231 
TITLE directive. 127 
%T1TLE: Specify Listing-File Title 
directive, 1015 

TITLE: Specify Listing-File Title 
directive. 1015 
tides 

listing files, 1015 
listings. 127 
subtides, listing files, 

1009-1010 

TUB program, 239. 243-244 
TUNK linker, 87-88 
BIN files, Unking, 337 
command Une, 160-161 
response files, 161-162 
tokenization, 342 
tools, debugging, 165-166 
Trace command, 180, 195-196 
track address fields, 451 
tracks 

disk, formatting, 514-515 
.formatting, 450-452 
order, 451 
sectors, 448, 450 
transferring control, 943 
Translate FAR calls where 
possible option, 100 
translating, 869 

Transmit Character (Intemipt 14h, 
service 1) BIOS service, 533 
transmitting characters, 533 
%TRUNC: Control Word- 
Wrapping in the Usdng File 
directive, 1016 

mr Character Output (Interrupt 
lOh, service OEh) BIOS service, 
497-498 

TIY characters, 497-498 
Turbo Assembler, 69-71 

compability to MASM, 70-71 
Turbo Debugger. 186-187, 
204-206 
Clipper, 342 
commands, 186 


Turbo BASIC, 265-266 
Turn Off C as sene Motor 
(Interrupt 15h, service 1) BIOS 
service, 538 

Turn On Cassene Motor 
(Interrupt 15h, service 0) BIOS 
service, 537-538 
two-pass assembler, 58 
TTPEDEF: Define a Pointer Type 
directive, 1016 
types 
align, 50 
class, 51 


_U_ 

UDATASEG. Define Beginning of 

Uninitialized Data, 1016-1017 
UDF (user-defined function), 341 
UFARDATA: Define Beginning of 
Uninitialized Far D, 1017 
Unassamble command. 180-181, 
192 

underline character, 310 
UNION: Define a Data Union 
directive, 1017-1018 
unions, data, defining, 1017-1018 
unreferenced variables, cross- 
referencing, 897 
.UNTIL: End a .REPEAT Loop 
directive, 1018-1019 
.UNT1LCXZ: End a .REPEAT Loop 
directive, 1019-1020 
uppercase tables, 710 
filename, 711-712 
upward compatible, 13 
Use Memory Swapping option, 
107 

Use MS-DOS Segment Ordering 
option, 99 

Use MS-DOS Segment Ordering 
without Nulls option, 102 
user-defined function (UDF), 341 
user-defined macros, 213 
users, identifiers 

case differences, 120 
uppercase, 120 
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USES: Specify Registers To Save 
directive. 1020-1021 
utilities 
BIND, 122 

program maintenance. 
209-216 


_ V 

values ”.” 

absolute, 774 
bytes, character attributes, 
485-489 

constant, labels, 918 
displacement, 47 
flags 

displaying, 179 
testing, 24 

integer, x-y coordinates, 386 
labels, assigning, 878 1 

parameters, accessing, 272 
passing, 317 
onto stack, 310 
register, displaying, 179 
returning, 260-261 
subroutine interface. 
349-350 

through a register, 261 
through memory, 261 
through the stack. 260 
searching for, 179-180 
segments. 17 
stacks, pushing. 294 
variable, sucks, pushing on, 
317 

word, 273 

variable passing, 285-286 
variables 

command-line options. 118 
communal, defining, 891-892 
cross-referencing, 896 
environment 
INCLUDE. 128 
library, 137 
macro definitions. 213 
restoring. 786 
float-type, 310 


integer. 273 
local, defining, 961 
passing. 292-295. 343-346 
subroutine interface, 
315-318 

to subroutines, 310 
pointers, passing, 295-301, 318 
referenced, cross-referencing, 
896-897 

string, passing to subroutine, 

261 W 

‘ unreferenced, cross- 
referencing, 897 
values, stacks, pushing on, 317 
VARPTR function, 277 
VARSEG function, 277 
verbose mode, 132 
Verify Disk Sectors (Interrupt 
13h, service 4) BIOS service. 
513-514 

verify flags, setting, 629-630 
verifying 

sectors, disks, 513-514 
segments 

for reading. 866-867 
for writing, 867 
VERR: Verify a Segment for 
Reading instruction, 866-867 
VERSION directive, 155 
VERSION: Specify Version 
Compatibility directive, 1021 

versions, compatibility, 1021 
VERW: Verify a Segment for 
Writing instruction, 867 
VGA (Video Graphics Array), 377 
adapter, 436-439 
port addresses. 436 
super cards, 377-378 
video 

adapter cards. 367 
buffer, 367 

cards, super VGA, 377-378 
controller, ports, 431-433 
display, 367-368 
memory- 367-411 
characters, displaying 
382-384 
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state, 498 

Video Graphics Array (VGA), 377 
video mode, setting, 477-478 
viewing code, 193*194 
virtual memory, enabling, 127 
virtual memory files, 92 
visibility directives, 874 
/VM option, 127 
VM.TMP file. 92 


_W_ 

/w option, 128 
WAIT: Wait instruction, 867 
waiting, 867 
warm boot, 564-565 
Warm Boot (Interrupt 19h) BIOS 
servicfc, 564-565 
Warn about Duplicate LIB 
Symbols option, 98 
WARN: Enable Warnings 
directive. 1021-1022 
warning level, 128 
warning messages, 279 
controlling, 156 
warnings 

disabling, 974-975 
enabling, 1021-1022 
error messages, 128 
watchdog timer, 553 
Watchdog Timer (Interrupt 15h, 
service C3h) BIOS service, 553 
WBINVD: Invalidate Cache and 
Write Back instruction, 867-868 
.WHILE: Declare the Beginning of 
a Controlled Loop directive, 
1022-1024 
.WHILE loop 
ending, 916-917 
modifying execution, 894-895 
terminating, 887-888 
WHILE...WEND loop, 270 
WHILE: Repeat a Block of 
Instructions directive, 1024 
windows 

Execution Profile, 232 
pop-up. 400 


restoring, 400-410 
saving. 400-410 
scrolling, 484-490 
source code, 202 
word^values, 273 
word-wrap, controlling, 974, 

1016 

WORD: Allocate a Word of 
Storage Space directive, 1025 
words 

bytes, convening from, 765 

control, 751-752 ^- 

loading, 786 
storing, 792 
converting 

to doublewords, 770 
to extended doubleword, 
770 

double, converting to 
quadwords, 766 
machine status, storing, 863 
signed storage space. 
1010-1011 
status, 752-753 
machine, 826 
storing, 792-793 
storage space, allocating*907, 
1025 

strings, scanning, 848 
words (bits), 21 

Write Character (Intemipt lOh, 
service OAh) BIOS service, 
492-493 

Write Character and Attribute 
(Interrupt lOh, service 9) BIOS 
service. 491-492 
Write command, 181 
Write Data Blocks to Cassette 
(Interrupt 15h, service 3) BIOS 
service, 539-540 
Write Disk Sectors (Intemipt 
13h, service 3) BIOS service, 
511*513 

Write File (Intemipt 21h, service 
40h) DOS services, 648-649 
Write Long Sectors (interrupt 
13h. service OBh) BIOS service, 
521-522 
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Write Pixel Dot (Interrupt lOh, 
service OCh) BIOS service, 
495-496 

Write Random Record(s), Using 
FCB (Interrupt 21h, service 
28h) DOS service, 622-624 
Write String (Interrupt lOh, 
service 13h) BIOS service, 
505-505 

Write to Keyboard Buffer 
(Interrupt l6h, service 05n) 
BIOS service, 559-560 
writes, disk, absolute, 724-725 
writing 

files, 648-649 
records, random, 622-624 
sectors 
disk, 511-513 
long, 521-522 
segments, verifying, 867 
strings, 503-505 
to buffers (keyboard) 559-560 


_X_ 

x-y coordinates, 386 
XADD: Exchange and Add to 
Memory instruction, 868 
JCA1L: List Only Macros that 
Generate Code directive, 
1025-1026 
xBase, 327 

files, extensions, 328 
XCHG: Exchange instruction, 868 
JCCREF: Disable Cross* 
Referencing directive, 1026 
XLAT: Translate instruction, 869 ' 
.XUST: Disable Source-Code 
Listing directive, 1026 
XOR: Logical Exdusive-Or 
instruction, 869 


_Z 

' n option, 132 
zero flag (ZF), 24 
ZF (zero flag), 24 
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earn the principles of assembly language 
structure, commands, and operations, with 
MB Que’s Using Assembly Language , 3rd Edition., 
Written from a programmer’s perspective,^ this 
power-packed text gives you insights on integrating 
today’s most popular assemblers, linkers, and 
debuggers. No other text covers more languages or 
more assembly language tools! 

You learn basic commands! functions, and tech 
niques for interfacing these subroutines with 
high-level languages like C + +, Turbo Pascal, 
FoxPro, and Clipper. 

The text helps you choose the right assembler and 
linker, providing expert tips on both Microsoft's 
Macro Assembler and Borland’s Turbo Assembler. 
You also learn how to work within different micro¬ 
computer processor environments, manipulate 
your monitor display, access individual hardware 
ports, and format floppy disks. A complete refer¬ 
ence section discusses BIOS services, DOS ser¬ 
vices, and detailed processor instruction sets. 

Add speed, versatility, and flexibility to all your 
programs with Using Assembly Language, 3rd Edi 
tion, from Que! * 
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Develop and debug 
logical assembly 
. language subroutines 
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needs 
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object-file libraries 
subroutines 

Integrate assembly 
language subroutines 
into C, C++, BASIC, 
Pascal, dBASE, FoxPro, 
and Clipper programs 

■ Use MASM and TASM 
directives to automate 
assembly language 
functions 
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